@qulib/mcp 0.5.3 → 0.7.0

package/dist/analyze-app-mcp-payload.d.ts

@@ -0,0 +1,12 @@
+import type { AnalyzeResult } from '@qulib/core';
+export interface AnalyzeAppMcpPayloadOptions {
+    includeFullReport?: boolean;
+    /** When true, returns only `toAgentSummary(result)` JSON (QLIB-001). Ignores `includeFullReport`. */
+    agentSummary?: boolean;
+}
+/**
+ * Single place for analyze_app response shaping: default summary-first,
+ * optional full report, or compact agent gate summary.
+ */
+export declare function buildAnalyzeAppMcpPayload(result: AnalyzeResult, input: AnalyzeAppMcpPayloadOptions): unknown;
+//# sourceMappingURL=analyze-app-mcp-payload.d.ts.map

package/dist/analyze-app-mcp-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-app-mcp-payload.d.ts","sourceRoot":"","sources":["../src/analyze-app-mcp-payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qGAAqG;IACrG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAKT"}

package/dist/analyze-app-mcp-payload.js

@@ -0,0 +1,12 @@
+import { toAgentSummary } from '@qulib/core';
+import { summarizeAnalyzeResult } from './summarize-analyze-result.js';
+/**
+ * Single place for analyze_app response shaping: default summary-first,
+ * optional full report, or compact agent gate summary.
+ */
+export function buildAnalyzeAppMcpPayload(result, input) {
+    if (input.agentSummary === true) {
+        return toAgentSummary(result);
+    }
+    return summarizeAnalyzeResult(result, input.includeFullReport === true);
+}

package/dist/index.js

@@ -14,9 +14,9 @@ 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, } from '@qulib/core';
+import { analyzeApp, detectAuth, exploreAuth, scanRepo, computeAutomationMaturity, scaffoldTests, } from '@qulib/core';
 import { z } from 'zod';
-import { summarizeAnalyzeResult } from './summarize-analyze-result.js';
+import { buildAnalyzeAppMcpPayload } from './analyze-app-mcp-payload.js';
 import { log } from './logger.js';
 function toolError(code, message, detail) {
     return {
@@ -68,6 +68,10 @@ const AnalyzeInputSchema = z.object({
     timeoutMs: z.number().int().positive().optional(),
     auth: z.discriminatedUnion('type', [FormLoginMcpAuthSchema, StorageStateMcpAuthSchema]).optional(),
     includeFullReport: z.boolean().optional(),
+    agentSummary: z
+        .boolean()
+        .optional()
+        .describe('When true, return only the versioned agent-summary JSON ({ schemaVersion: 1, gate, coverageStatus, topRisks, recommendedNextChecks, honestyNotes, costSummary, deterministicFollowUps }). Use this for CI gates and orchestrators that need a single small payload to decide pass/warn/fail. Overrides includeFullReport.'),
     llmTokenBudget: z.number().int().positive().optional(),
     llmMaxOutputTokensPerCall: z.number().int().positive().optional(),
     testGenerationLimit: z.number().int().positive().max(50).optional(),
@@ -153,7 +157,7 @@ mcpServer.registerTool('detect_auth', {
     }
 });
 mcpServer.registerTool('analyze_app', {
-    description: 'Analyze a deployed web app for quality gaps. Default response is summary-first (top gaps, cost summary, next checks). Set includeFullReport for the full gapAnalysis. Optional llmMaxOutputTokensPerCall / llmTokenBudget (legacy), testGenerationLimit, enableLlmScenarios align with @qulib/core HarnessConfig.',
+    description: 'Analyze a deployed web app for quality gaps. Default response is summary-first (top gaps, cost summary, next checks). Set includeFullReport for the full gapAnalysis. Set agentSummary for the compact gate-decision payload (pass/warn/fail with honesty notes) — use this when calling from a CI gate or orchestrator. Optional llmMaxOutputTokensPerCall / llmTokenBudget (legacy), testGenerationLimit, enableLlmScenarios align with @qulib/core HarnessConfig.',
     inputSchema: AnalyzeInputSchema,
 }, async (input) => {
     try {
@@ -202,7 +206,10 @@ mcpServer.registerTool('analyze_app', {
             progressLog: mcpProgressLog,
             telemetry: telemetrySink,
         });
-        const payload = summarizeAnalyzeResult(result, input.includeFullReport === true);
+        const payload = buildAnalyzeAppMcpPayload(result, {
+            includeFullReport: input.includeFullReport,
+            agentSummary: input.agentSummary,
+        });
         return {
             content: [
                 {
@@ -254,5 +261,53 @@ mcpServer.registerTool('qulib_score_automation', {
         return toolError('QULIB_REPO_SCORE_FAILED', msg, err instanceof Error ? err.stack : undefined);
     }
 });
+const ScaffoldTestsInputSchema = z.object({
+    url: z.string().url().describe('URL of the deployed web app to scaffold tests for'),
+    framework: z
+        .enum(['cypress-e2e', 'playwright'])
+        .optional()
+        .describe('Test framework to generate. Default: cypress-e2e'),
+    maxPagesToScan: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe('Max pages to crawl when running analyze_app internally. Default: 10'),
+});
+mcpServer.registerTool('qulib_scaffold_tests', {
+    description: 'Generate a ready-to-run test scaffold for a deployed web app. Crawls the URL, identifies quality gaps and user flows, then produces framework-specific test files (Cypress or Playwright) plus the project config (cypress.config.ts or playwright.config.ts) and package.json deps. Returns generatedTests (array of {filename, code, outputPath}) and projectConfig so an agent can write the files directly to a repo without any manual test-writing.',
+    inputSchema: ScaffoldTestsInputSchema,
+}, async ({ url, framework, maxPagesToScan }) => {
+    try {
+        log.info(`qulib_scaffold_tests url=${url} framework=${framework ?? 'cypress-e2e'} maxPagesToScan=${maxPagesToScan ?? 10}`);
+        const result = await scaffoldTests(url, {
+            framework: framework ?? 'cypress-e2e',
+            maxPagesToScan: maxPagesToScan ?? 10,
+            progressLog: mcpProgressLog,
+            telemetry: telemetrySink,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        url: result.url,
+                        framework: result.framework,
+                        scenarioCount: result.scenarios.length,
+                        testCount: result.generatedTests.length,
+                        generatedTests: result.generatedTests,
+                        projectConfig: result.projectConfig,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`qulib_scaffold_tests failed: ${msg}`);
+        return toolError('QULIB_SCAFFOLD_FAILED', msg, err instanceof Error ? err.stack : undefined);
+    }
+});
 const transport = new StdioServerTransport();
 await mcpServer.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qulib/mcp",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "MCP server for Qulib — AI-callable QA gap analysis",
   "license": "MIT",
   "author": "Tapesh Nagarwal",
@@ -29,11 +29,11 @@
   "scripts": {
     "build": "npm --prefix ../.. run build -w @qulib/core && tsc && chmod +x dist/index.js",
     "dev": "tsx src/index.ts",
-    "test": "node --import tsx/esm --test src/__tests__/summarize-analyze-result.test.ts"
+    "test": "node --import tsx/esm --test src/__tests__/summarize-analyze-result.test.ts src/__tests__/analyze-app-mcp-payload.test.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@qulib/core": "0.5.3",
+    "@qulib/core": "0.7.0",
     "zod": "^3.23.0"
   },
   "devDependencies": {