@qulib/mcp 0.10.0 → 0.10.1

package/dist/index.d.ts

@@ -1,3 +1,13 @@
 #!/usr/bin/env node
-export {};
+export declare function handleQulibDiff(input: {
+    from: string;
+    to: string;
+    labelFrom?: string;
+    labelTo?: string;
+}): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAoqBA,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAsBzD"}

package/dist/index.js

@@ -10,25 +10,17 @@
 // vs. write-capable tools (analyze_app with writeArtifacts) should carry different trust levels.
 import { createRequire } from 'node:module';
 import { isAbsolute, normalize, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 const requirePkg = createRequire(import.meta.url);
 const pkg = requirePkg('../package.json');
-import { analyzeApp, detectAuth, exploreAuth, scanRepo, computeAutomationMaturity, scaffoldTests, discoverApiSurfaceWithRepo, computeApiCoverage, computeReleaseConfidence, buildConfidenceInputFromQulib, } from '@qulib/core';
+import { analyzeApp, detectAuth, exploreAuth, scanRepo, computeAutomationMaturity, scaffoldTests, discoverApiSurfaceWithRepo, computeApiCoverage, computeReleaseConfidence, buildConfidenceInputFromQulib, analyzeRunDiff, loadGapAnalysisFile, detectPromptLeakage, } from '@qulib/core';
 import { RecipeIdSchema } from '@qulib/core';
 import { z } from 'zod';
 import { buildAnalyzeAppMcpPayload } from './analyze-app-mcp-payload.js';
 import { log } from './logger.js';
-function toolError(code, message, detail) {
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({ error: { code, message, detail: detail ?? null } }, null, 2),
-            },
-        ],
-    };
-}
+import { toolError } from './tool-error.js';
 function stderrTelemetrySink() {
     return {
         emit(event) {
@@ -511,5 +503,96 @@ mcpServer.registerTool('qulib_score_confidence', {
         return toolError('QULIB_CONFIDENCE_FAILED', msg, err instanceof Error ? err.stack : undefined);
     }
 });
-const transport = new StdioServerTransport();
-await mcpServer.connect(transport);
+function validateAbsoluteGapAnalysisPath(path) {
+    const norm = normalize(path.trim());
+    if (!isAbsolute(norm)) {
+        throw new Error('from and to must be absolute paths');
+    }
+    return resolve(norm);
+}
+export async function handleQulibDiff(input) {
+    try {
+        const fromPath = validateAbsoluteGapAnalysisPath(input.from);
+        const toPath = validateAbsoluteGapAnalysisPath(input.to);
+        log.info(`qulib_diff from=${fromPath} to=${toPath}`);
+        const fromGap = await loadGapAnalysisFile(fromPath);
+        const toGap = await loadGapAnalysisFile(toPath);
+        const result = analyzeRunDiff(fromGap, toGap, {
+            fromLabel: input.labelFrom,
+            toLabel: input.labelTo,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('from and to must be absolute paths')) {
+            return toolError('QULIB_DIFF_INVALID_INPUT', 'from and to must be absolute paths');
+        }
+        log.error(`qulib_diff failed: ${msg}`);
+        return toolError('QULIB_DIFF_FAILED', msg, err instanceof Error ? err.stack : undefined);
+    }
+}
+const QulibDiffInputSchema = z.object({
+    from: z
+        .string()
+        .describe('Absolute path to the baseline qulib report.json (the "before" analyze output)'),
+    to: z
+        .string()
+        .describe('Absolute path to the current qulib report.json (the "after" analyze output)'),
+    labelFrom: z
+        .string()
+        .optional()
+        .describe('Optional human label for the baseline report (default: the from path)'),
+    labelTo: z
+        .string()
+        .optional()
+        .describe('Optional human label for the current report (default: the to path)'),
+});
+mcpServer.registerTool('qulib_diff', {
+    description: 'Structured diff between two analyze outputs — added findings, resolved findings, severity changes, and a confidence delta.',
+    inputSchema: QulibDiffInputSchema,
+}, handleQulibDiff);
+// ---------------------------------------------------------------------------
+// qulib_detect_prompt_leakage — scan a page surface for exposed AI system prompts
+// ---------------------------------------------------------------------------
+const DetectPromptLeakageInputSchema = z.object({
+    path: z.string().describe('The URL path being scanned (used as the gap path label, e.g. "/api/chat")'),
+    bodySnippet: z
+        .string()
+        .max(8000)
+        .optional()
+        .describe('Up to 8000 characters of raw HTML body from the page. Include inline scripts, HTML comments, meta tags, and any visible text.'),
+    headers: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('Response headers from the page request, as a flat string→string map.'),
+});
+mcpServer.registerTool('qulib_detect_prompt_leakage', {
+    description: 'Scan a captured page surface (HTML body, inline scripts, HTML comments, meta tags, response headers) for signals that an AI system prompt or agent instructions are inadvertently exposed to the public. Conservative — requires corroborating signals to minimise false positives. Returns an array of prompt-leakage Gaps (may be empty when nothing is detected). Each Gap includes severity (critical/high/medium), evidence, and a remediation recommendation.',
+    inputSchema: DetectPromptLeakageInputSchema,
+}, async ({ path, bodySnippet, headers }) => {
+    try {
+        log.info(`qulib_detect_prompt_leakage path=${path}`);
+        const gaps = detectPromptLeakage({ path, bodySnippet, headers });
+        log.info(`qulib_detect_prompt_leakage done gapsFound=${gaps.length}`);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ path, gapsFound: gaps.length, gaps }, null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`qulib_detect_prompt_leakage failed: ${msg}`);
+        return toolError('QULIB_PROMPT_LEAKAGE_FAILED', msg, err instanceof Error ? err.stack : undefined);
+    }
+});
+async function startMcpServer() {
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+}
+const isDirectExecution = process.argv[1] !== undefined &&
+    fileURLToPath(import.meta.url) === resolve(process.argv[1]);
+if (isDirectExecution) {
+    await startMcpServer();
+}

package/dist/summarize-analyze-result.d.ts

@@ -96,7 +96,7 @@ export declare function summarizeAnalyzeResult(result: AnalyzeResult, includeFul
     };
     topGaps: {
         path: string;
-        category: "untested-route" | "a11y" | "console-error" | "broken-link" | "auth-surface" | "coverage" | "untested-api-endpoint";
+        category: "untested-route" | "a11y" | "console-error" | "broken-link" | "auth-surface" | "coverage" | "untested-api-endpoint" | "prompt-leakage";
         severity: "critical" | "high" | "medium" | "low";
         reason: string;
     }[];
@@ -152,7 +152,7 @@ export declare function summarizeAnalyzeResult(result: AnalyzeResult, includeFul
             id: string;
             severity: "critical" | "high" | "medium" | "low";
             reason: string;
-            category: "untested-route" | "a11y" | "console-error" | "broken-link" | "auth-surface" | "coverage" | "untested-api-endpoint";
+            category: "untested-route" | "a11y" | "console-error" | "broken-link" | "auth-surface" | "coverage" | "untested-api-endpoint" | "prompt-leakage";
             recommendation?: string | undefined;
             description?: string | undefined;
         }[];

package/dist/summarize-analyze-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize-analyze-result.d.ts","sourceRoot":"","sources":["../src/summarize-analyze-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAqBjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA6G84d,CAAC;sBAA4C,CAAC;sBAA4C,CAAC;iBAAuC,CAAC;;;;;;;;;;;;;;;;;uBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;EADznf"}
+{"version":3,"file":"summarize-analyze-result.d.ts","sourceRoot":"","sources":["../src/summarize-analyze-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAqBjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA6Gihe,CAAC;sBAA4C,CAAC;sBAA4C,CAAC;iBAAuC,CAAC;;;;;;;;;;;;;;;;;uBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;EAD5vf"}

package/dist/tool-error.d.ts

@@ -0,0 +1,7 @@
+export declare function toolError(code: string, message: string, detail?: unknown): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+//# sourceMappingURL=tool-error.d.ts.map

package/dist/tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.ts","sourceRoot":"","sources":["../src/tool-error.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG;IAC1E,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C,CASA"}

package/dist/tool-error.js

@@ -0,0 +1,10 @@
+export function toolError(code, message, detail) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ error: { code, message, detail: detail ?? null } }, null, 2),
+            },
+        ],
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qulib/mcp",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "MCP server for Qulib — AI-callable release confidence. Seven tools: fused verdict, live-app scan, automation maturity, API coverage, test scaffold, and auth tools.",
   "license": "MIT",
   "author": "Tapesh Nagarwal",
@@ -30,11 +30,11 @@
     "build": "npm --prefix ../.. run build -w @qulib/core && tsc && chmod +x dist/index.js",
     "prepublishOnly": "npm run build",
     "dev": "tsx src/index.ts",
-    "test": "node --import tsx/esm --test src/__tests__/summarize-analyze-result.test.ts src/__tests__/analyze-app-mcp-payload.test.ts src/__tests__/score-confidence-mcp.test.ts src/__tests__/naming-aliases.test.ts"
+    "test": "node --import tsx/esm --test src/__tests__/summarize-analyze-result.test.ts src/__tests__/analyze-app-mcp-payload.test.ts src/__tests__/score-confidence-mcp.test.ts src/__tests__/naming-aliases.test.ts src/__tests__/diff.test.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@qulib/core": "0.10.0",
+    "@qulib/core": "0.10.1",
     "zod": "^3.23.0"
   },
   "devDependencies": {