sniff-qa 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/README.md +75 -5
  2. package/dist/classifier-MWQMQ727.js +1701 -0
  3. package/dist/classifier-MWQMQ727.js.map +1 -0
  4. package/dist/cli/index.js +92 -27
  5. package/dist/cli/index.js.map +1 -1
  6. package/dist/dev-server-detector-XQ5AYPDT.js +319 -0
  7. package/dist/dev-server-detector-XQ5AYPDT.js.map +1 -0
  8. package/dist/discover-JRU5E4FR.js +327 -0
  9. package/dist/discover-JRU5E4FR.js.map +1 -0
  10. package/dist/domain-UQ34YE4B.js +1817 -0
  11. package/dist/domain-UQ34YE4B.js.map +1 -0
  12. package/dist/edge-cases-ZADKDZHL.js +246 -0
  13. package/dist/edge-cases-ZADKDZHL.js.map +1 -0
  14. package/dist/ensure-browsers-ACHCEQCT.js +60 -0
  15. package/dist/ensure-browsers-ACHCEQCT.js.map +1 -0
  16. package/dist/flakiness-OLJAY7CS.js +53 -0
  17. package/dist/flakiness-OLJAY7CS.js.map +1 -0
  18. package/dist/init-IQKT4ANC.js +148 -0
  19. package/dist/init-IQKT4ANC.js.map +1 -0
  20. package/dist/llm-VJAI6H6G.js +126 -0
  21. package/dist/llm-VJAI6H6G.js.map +1 -0
  22. package/dist/mcp/server.js +219 -1
  23. package/dist/mcp/server.js.map +1 -1
  24. package/dist/persistence-KTCRIGHU.js +270 -0
  25. package/dist/persistence-KTCRIGHU.js.map +1 -0
  26. package/dist/{repo-analyzer-WK5WP7NT.js → repo-analyzer-4OURSITY.js} +1 -1
  27. package/dist/{report-WLDV72FM.js → report-IKRVVIW4.js} +1 -1
  28. package/dist/report-SDZWX25B.js +280 -0
  29. package/dist/report-SDZWX25B.js.map +1 -0
  30. package/dist/runner-OYTN2NFD.js +996 -0
  31. package/dist/runner-OYTN2NFD.js.map +1 -0
  32. package/dist/scenarios-I7YYVTD2.js +987 -0
  33. package/dist/scenarios-I7YYVTD2.js.map +1 -0
  34. package/dist/tiebreak-L5UFNKU2.js +60 -0
  35. package/dist/tiebreak-L5UFNKU2.js.map +1 -0
  36. package/dist/{unified-7RKNG3EI.js → unified-JCUBP6UO.js} +2 -2
  37. package/package.json +2 -2
  38. package/dist/dev-server-detector-NJ5RN4IC.js +0 -150
  39. package/dist/dev-server-detector-NJ5RN4IC.js.map +0 -1
  40. package/dist/init-75MMIW4A.js +0 -66
  41. package/dist/init-75MMIW4A.js.map +0 -1
  42. /package/dist/{repo-analyzer-WK5WP7NT.js.map → repo-analyzer-4OURSITY.js.map} +0 -0
  43. /package/dist/{report-WLDV72FM.js.map → report-IKRVVIW4.js.map} +0 -0
  44. /package/dist/{unified-7RKNG3EI.js.map → unified-JCUBP6UO.js.map} +0 -0
@@ -96,6 +96,142 @@ async function handleSniffRun(rootDir, baseUrl, headless) {
96
96
  ]
97
97
  };
98
98
  }
99
+ async function handleSniffDiscover(options) {
100
+ const rootErr = validateRootDir(options.rootDir);
101
+ if (rootErr) {
102
+ return { content: [{ type: "text", text: JSON.stringify({ error: rootErr }) }] };
103
+ }
104
+ if (!options.baseUrl && !options.dryRun) {
105
+ return {
106
+ content: [
107
+ {
108
+ type: "text",
109
+ text: JSON.stringify({
110
+ error: "No baseUrl provided and no local dev server detected. Start your dev server or pass baseUrl."
111
+ })
112
+ }
113
+ ]
114
+ };
115
+ }
116
+ if (options.baseUrl) {
117
+ const urlErr = validateBaseUrl(options.baseUrl);
118
+ if (urlErr) {
119
+ return { content: [{ type: "text", text: JSON.stringify({ error: urlErr }) }] };
120
+ }
121
+ }
122
+ if (!options.dryRun) {
123
+ const { checkPlaywrightBrowsers } = await import("../ensure-browsers-ACHCEQCT.js");
124
+ const check = await checkPlaywrightBrowsers();
125
+ if (check.status !== "installed") {
126
+ return {
127
+ content: [{
128
+ type: "text",
129
+ text: JSON.stringify({
130
+ needsSetup: "playwright-chromium",
131
+ installCommand: check.status === "missing" ? check.installCommand : "npx playwright install chromium",
132
+ installSizeMb: check.status === "missing" ? check.installSizeMb : 165,
133
+ hint: "Run the sniff_install MCP tool, or run the install command manually, then retry."
134
+ })
135
+ }]
136
+ };
137
+ }
138
+ }
139
+ const { discoverCommand } = await import("../discover-JRU5E4FR.js");
140
+ const result = await discoverCommand({
141
+ rootDir: options.rootDir,
142
+ ...options.baseUrl ? { url: options.baseUrl } : {},
143
+ headless: options.headless ?? true,
144
+ nonInteractive: true,
145
+ json: true,
146
+ ...options.maxScenarios !== void 0 ? { maxScenarios: options.maxScenarios } : {},
147
+ ...options.maxVariantsPerScenario !== void 0 ? { maxVariantsPerScenario: options.maxVariantsPerScenario } : {},
148
+ ...options.maxVariantsPerRun !== void 0 ? { maxVariantsPerRun: options.maxVariantsPerRun } : {},
149
+ ...options.realism !== void 0 ? { realism: options.realism } : {},
150
+ ...options.seed !== void 0 ? { seed: options.seed } : {},
151
+ ...options.only !== void 0 ? { only: options.only } : {},
152
+ ...options.appType !== void 0 ? { appType: options.appType } : {},
153
+ ...options.forceAppType !== void 0 ? { forceAppType: options.forceAppType } : {},
154
+ ...options.dryRun ? { dryRun: true } : {}
155
+ });
156
+ const reports = {};
157
+ for (const p of result.savedPaths) {
158
+ if (p.endsWith(".html")) reports.html = p;
159
+ else if (p.endsWith(".xml")) reports.junit = p;
160
+ else if (p.endsWith(".json")) reports.json = p;
161
+ }
162
+ const summary = {
163
+ baseUrl: result.baseUrl,
164
+ detectedFrom: result.detectedFrom,
165
+ stats: result.report.stats,
166
+ topAppType: result.report.appTypeGuesses[0]?.type,
167
+ topAppConfidence: result.report.appTypeGuesses[0]?.confidence,
168
+ classificationBreakdown: result.report.classificationBreakdown,
169
+ ...result.dryRun ? { dryRun: result.dryRun } : {},
170
+ reports,
171
+ savedPaths: result.savedPaths,
172
+ failedScenarios: result.report.scenarios.filter((s) => s.status === "fail" && s.quarantined !== true).map((s) => ({
173
+ id: s.scenario.id,
174
+ name: s.scenario.name,
175
+ failureReason: s.steps.find((step) => step.status === "fail")?.failureReason
176
+ })),
177
+ exitCode: result.exitCode
178
+ };
179
+ return {
180
+ content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
181
+ };
182
+ }
183
+ async function handleSniffUnified(options) {
184
+ switch (options.mode) {
185
+ case "scan":
186
+ return handleSniffScan(options.rootDir);
187
+ case "run": {
188
+ let url = options.baseUrl;
189
+ if (!url) {
190
+ const { detectDevServerUrl } = await import("../dev-server-detector-XQ5AYPDT.js");
191
+ const detection = await detectDevServerUrl(options.rootDir);
192
+ url = detection.url;
193
+ }
194
+ if (!url) return handleSniffScan(options.rootDir);
195
+ return handleSniffRun(options.rootDir, url, options.headless ?? true);
196
+ }
197
+ case "discover": {
198
+ let url = options.baseUrl;
199
+ if (!url && !options.dryRun) {
200
+ const { detectDevServerUrl } = await import("../dev-server-detector-XQ5AYPDT.js");
201
+ const detection = await detectDevServerUrl(options.rootDir);
202
+ url = detection.url;
203
+ }
204
+ return handleSniffDiscover({
205
+ rootDir: options.rootDir,
206
+ ...url ? { baseUrl: url } : {},
207
+ headless: options.headless ?? true,
208
+ ...options.maxScenarios !== void 0 ? { maxScenarios: options.maxScenarios } : {},
209
+ ...options.maxVariantsPerScenario !== void 0 ? { maxVariantsPerScenario: options.maxVariantsPerScenario } : {},
210
+ ...options.maxVariantsPerRun !== void 0 ? { maxVariantsPerRun: options.maxVariantsPerRun } : {},
211
+ ...options.realism !== void 0 ? { realism: options.realism } : {},
212
+ ...options.seed !== void 0 ? { seed: options.seed } : {},
213
+ ...options.only !== void 0 ? { only: options.only } : {},
214
+ ...options.appType !== void 0 ? { appType: options.appType } : {},
215
+ ...options.forceAppType !== void 0 ? { forceAppType: options.forceAppType } : {},
216
+ ...options.dryRun ? { dryRun: true } : {}
217
+ });
218
+ }
219
+ case "report":
220
+ return handleSniffReport(options.rootDir, options.format ?? "summary");
221
+ }
222
+ }
223
+ async function handleSniffInstall() {
224
+ const { installPlaywrightBrowsers } = await import("../ensure-browsers-ACHCEQCT.js");
225
+ const result = await installPlaywrightBrowsers();
226
+ return {
227
+ content: [{
228
+ type: "text",
229
+ text: JSON.stringify(
230
+ result.status === "ok" ? { status: "installed", browser: "chromium" } : { status: "failed", error: result.error, hint: "Run `npx playwright install chromium` manually for full error output." }
231
+ )
232
+ }]
233
+ };
234
+ }
99
235
  async function handleSniffReport(rootDir, format) {
100
236
  const rootErr = validateRootDir(rootDir);
101
237
  if (rootErr) {
@@ -139,6 +275,27 @@ async function startMcpServer() {
139
275
  name: "sniff",
140
276
  version: getVersion()
141
277
  });
278
+ server.tool(
279
+ "sniff",
280
+ 'Unified entry point. Pass { mode: "scan" | "run" | "discover" | "report", rootDir, ...} to dispatch. Prefer this over the narrow tools (sniff_scan / sniff_run / sniff_discover / sniff_report) which are kept only for back-compat.',
281
+ {
282
+ mode: z.enum(["scan", "run", "discover", "report"]).describe("scan = source only, run = source + browser audit, discover = autonomous E2E, report = load last results"),
283
+ rootDir: z.string().describe("Absolute path to the project root directory"),
284
+ baseUrl: z.string().optional(),
285
+ headless: z.boolean().optional(),
286
+ format: z.enum(["json", "summary"]).optional(),
287
+ maxScenarios: z.number().int().min(1).max(200).optional(),
288
+ maxVariantsPerScenario: z.number().int().min(0).max(20).optional(),
289
+ maxVariantsPerRun: z.number().int().min(0).max(200).optional(),
290
+ realism: z.enum(["robot", "careful-user", "casual-user", "frustrated-user", "power-user"]).optional(),
291
+ seed: z.number().int().optional(),
292
+ only: z.string().optional(),
293
+ appType: z.array(z.string()).optional(),
294
+ forceAppType: z.string().optional(),
295
+ dryRun: z.boolean().optional()
296
+ },
297
+ async (args) => handleSniffUnified(args)
298
+ );
142
299
  server.tool(
143
300
  "sniff_scan",
144
301
  "Scan project source code for bugs. Finds debug statements, placeholder text, dead links, broken imports, hardcoded URLs, and API endpoint issues (missing validation, auth, error handling, secrets). Works offline, no browser or API key needed. Just pass the project path.",
@@ -158,16 +315,77 @@ async function startMcpServer() {
158
315
  async ({ rootDir, baseUrl, headless }) => {
159
316
  let url = baseUrl;
160
317
  if (!url) {
161
- const { detectDevServerUrl } = await import("../dev-server-detector-NJ5RN4IC.js");
318
+ const { detectDevServerUrl } = await import("../dev-server-detector-XQ5AYPDT.js");
162
319
  const detection = await detectDevServerUrl(rootDir);
163
320
  url = detection.url;
164
321
  }
165
322
  if (url) {
323
+ const { checkPlaywrightBrowsers } = await import("../ensure-browsers-ACHCEQCT.js");
324
+ const check = await checkPlaywrightBrowsers();
325
+ if (check.status !== "installed") {
326
+ return {
327
+ content: [{
328
+ type: "text",
329
+ text: JSON.stringify({
330
+ needsSetup: "playwright-chromium",
331
+ installCommand: check.status === "missing" ? check.installCommand : "npx playwright install chromium",
332
+ installSizeMb: check.status === "missing" ? check.installSizeMb : 165,
333
+ hint: "Run the sniff_install MCP tool, or run the install command manually, then retry."
334
+ })
335
+ }]
336
+ };
337
+ }
166
338
  return handleSniffRun(rootDir, url, headless);
167
339
  }
168
340
  return handleSniffScan(rootDir);
169
341
  }
170
342
  );
343
+ server.tool(
344
+ "sniff_discover",
345
+ "Run autonomous end-to-end discovery: extract the app domain from source, classify the app type, generate scenarios with edge-case variants, drive them through Playwright, and return a compact summary. Requires a running dev server (baseUrl optional, auto-detected if omitted). Writes HTML/JSON reports to sniff-reports/discovery/.",
346
+ {
347
+ rootDir: z.string().describe("Absolute path to the project root directory"),
348
+ baseUrl: z.string().optional().describe("URL of the running app. Optional -- sniff auto-detects localhost servers if omitted."),
349
+ headless: z.boolean().default(true).describe("Run browser in headless mode"),
350
+ maxScenarios: z.number().int().min(1).max(200).optional().describe("Cap total scenarios (default: 50)"),
351
+ maxVariantsPerScenario: z.number().int().min(0).max(20).optional().describe("Cap edge variants per scenario (default: 3)"),
352
+ maxVariantsPerRun: z.number().int().min(0).max(200).optional().describe("Cap edge variants per run (default: 40)"),
353
+ realism: z.enum(["robot", "careful-user", "casual-user", "frustrated-user", "power-user"]).optional().describe("Realism profile (default: robot in CI, casual-user otherwise)"),
354
+ seed: z.number().int().optional().describe("Replay a specific random seed"),
355
+ only: z.string().optional().describe("Filter scenarios by id substring or app type"),
356
+ appType: z.array(z.string()).optional().describe("Filter classifier guesses to these app types (does NOT bypass classification \u2014 use forceAppType for that)"),
357
+ forceAppType: z.string().optional().describe("Force a single app type, bypassing the classifier entirely. Use when classification returns blank."),
358
+ dryRun: z.boolean().optional().describe("Generate scenarios + classify without launching a browser or writing reports. Useful for preview.")
359
+ },
360
+ async (args) => {
361
+ let url = args.baseUrl;
362
+ if (!url) {
363
+ const { detectDevServerUrl } = await import("../dev-server-detector-XQ5AYPDT.js");
364
+ const detection = await detectDevServerUrl(args.rootDir);
365
+ url = detection.url;
366
+ }
367
+ return handleSniffDiscover({
368
+ rootDir: args.rootDir,
369
+ baseUrl: url,
370
+ headless: args.headless,
371
+ ...args.maxScenarios !== void 0 ? { maxScenarios: args.maxScenarios } : {},
372
+ ...args.maxVariantsPerScenario !== void 0 ? { maxVariantsPerScenario: args.maxVariantsPerScenario } : {},
373
+ ...args.maxVariantsPerRun !== void 0 ? { maxVariantsPerRun: args.maxVariantsPerRun } : {},
374
+ ...args.realism !== void 0 ? { realism: args.realism } : {},
375
+ ...args.seed !== void 0 ? { seed: args.seed } : {},
376
+ ...args.only !== void 0 ? { only: args.only } : {},
377
+ ...args.appType !== void 0 ? { appType: args.appType } : {},
378
+ ...args.forceAppType !== void 0 ? { forceAppType: args.forceAppType } : {},
379
+ ...args.dryRun !== void 0 ? { dryRun: args.dryRun } : {}
380
+ });
381
+ }
382
+ );
383
+ server.tool(
384
+ "sniff_install",
385
+ "Install the Playwright Chromium binary (~165MB, one-time). Run this when sniff_run or sniff_discover returns `needsSetup: playwright-chromium`.",
386
+ {},
387
+ async () => handleSniffInstall()
388
+ );
171
389
  server.tool(
172
390
  "sniff_report",
173
391
  "Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.",
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/mcp/server.ts","../../src/mcp/handlers.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { handleSniffScan, handleSniffRun, handleSniffReport } from './handlers.js';\nimport { getVersion } from '../version.js';\n\nexport async function startMcpServer(): Promise<void> {\n const server = new McpServer({\n name: 'sniff',\n version: getVersion(),\n });\n\n // Tool: sniff_scan -- static source analysis (no browser needed)\n server.tool(\n 'sniff_scan',\n 'Scan project source code for bugs. Finds debug statements, placeholder text, dead links, broken imports, hardcoded URLs, and API endpoint issues (missing validation, auth, error handling, secrets). Works offline, no browser or API key needed. Just pass the project path.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n },\n async ({ rootDir }) => handleSniffScan(rootDir),\n );\n\n // Tool: sniff_run -- full audit (source + browser, auto-detects URL)\n server.tool(\n 'sniff_run',\n 'Run a full quality audit: source scan + browser checks (accessibility, visual regression, performance). The URL is optional -- sniff auto-detects running dev servers. If no server is found, runs source scan only. No API key needed.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional().describe('URL of the running app. Optional -- sniff auto-detects localhost servers if omitted.'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n },\n async ({ rootDir, baseUrl, headless }) => {\n // Auto-detect URL if not provided\n let url = baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(rootDir);\n url = detection.url;\n }\n\n if (url) {\n return handleSniffRun(rootDir, url, headless);\n }\n\n // No server found -- fall back to source scan only\n return handleSniffScan(rootDir);\n },\n );\n\n // Tool: sniff_report -- load last results\n server.tool(\n 'sniff_report',\n 'Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n format: z.enum(['json', 'summary']).default('summary').describe('Output format: full JSON or text summary'),\n },\n async ({ rootDir, format }) => handleSniffReport(rootDir, format),\n );\n\n // Connect via stdio transport\n const transport = new StdioServerTransport();\n await server.connect(transport);\n}\n","import { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport type { Finding, BrowserFinding } from '../core/types.js';\n\nexport interface McpToolResult {\n [key: string]: unknown;\n content: Array<{ type: 'text'; text: string }>;\n}\n\n/**\n * Validate rootDir is absolute and exists on disk (T-04-15 mitigation).\n */\nfunction validateRootDir(rootDir: string): string | null {\n const resolved = resolve(rootDir);\n if (resolved !== rootDir) {\n return `rootDir must be an absolute path, got: ${rootDir}`;\n }\n if (!existsSync(resolved)) {\n return `rootDir does not exist: ${resolved}`;\n }\n return null;\n}\n\n/**\n * Validate baseUrl is a valid http/https URL (T-04-16 mitigation).\n */\nfunction validateBaseUrl(baseUrl: string): string | null {\n try {\n const parsed = new URL(baseUrl);\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n return `baseUrl must use http or https scheme, got: ${parsed.protocol}`;\n }\n return null;\n } catch {\n return `Invalid URL: ${baseUrl}`;\n }\n}\n\nexport async function handleSniffScan(rootDir: string): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { ScannerRegistry } = await import('../scanners/registry.js');\n const { SourceScanner } = await import('../scanners/source/index.js');\n\n const config = await loadConfig(rootDir);\n const registry = new ScannerRegistry();\n registry.register(new SourceScanner());\n\n const results = await registry.runAll({ config, rootDir });\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n };\n}\n\nexport async function handleSniffRun(\n rootDir: string,\n baseUrl: string,\n headless: boolean,\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const urlErr = validateBaseUrl(baseUrl);\n if (urlErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: urlErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { BrowserRunner } = await import('../browser/runner.js');\n const { AccessibilityScanner } = await import('../scanners/accessibility/index.js');\n const { VisualRegressionScanner } = await import('../scanners/visual/index.js');\n const { PerformanceScanner } = await import('../scanners/performance/index.js');\n\n const config = await loadConfig(rootDir);\n\n const runner = new BrowserRunner(config);\n runner.registerScanner(new AccessibilityScanner());\n runner.registerScanner(new VisualRegressionScanner());\n runner.registerScanner(new PerformanceScanner());\n\n const result = await runner.run({\n baseUrl,\n testFiles: ['/'],\n viewports: config.viewports ?? [{ name: 'desktop', width: 1280, height: 720 }],\n headless,\n slowMo: 0,\n timeout: config.browser?.timeout ?? 30000,\n });\n\n // Type both groups explicitly to avoid Finding vs BrowserFinding incompatibility\n const allFindings: Array<Finding | BrowserFinding> = [\n ...result.scanResults.flatMap((r) => r.findings),\n ...result.pageVisits.flatMap((v) => v.findings),\n ];\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(\n {\n findings: allFindings,\n urls: result.urls,\n duration: result.duration,\n findingCount: allFindings.length,\n },\n null,\n 2,\n ),\n },\n ],\n };\n}\n\nexport async function handleSniffReport(\n rootDir: string,\n format: 'json' | 'summary',\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadLastResults } = await import('../core/persistence.js');\n const results = await loadLastResults(rootDir);\n\n if (!results) {\n return {\n content: [\n {\n type: 'text',\n text: 'No previous sniff results found. Run sniff_scan or sniff_run first.',\n },\n ],\n };\n }\n\n if (format === 'json') {\n return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };\n }\n\n // Summary format\n const totalFindings = results.results.reduce((sum, r) => sum + r.findings.length, 0);\n const bySeverity: Record<string, number> = {};\n for (const r of results.results) {\n for (const f of r.findings) {\n bySeverity[f.severity] = (bySeverity[f.severity] ?? 0) + 1;\n }\n }\n const scanners = results.results.map((r) => r.scanner).join(', ');\n const summary = [\n `Sniff Results (${results.timestamp})`,\n `Scanners: ${scanners}`,\n `Total findings: ${totalFindings}`,\n ...Object.entries(bySeverity).map(([sev, count]) => ` ${sev}: ${count}`),\n ].join('\\n');\n\n return { content: [{ type: 'text', text: summary }] };\n}\n"],"mappings":";;;;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;AACrC,SAAS,SAAS;;;ACFlB,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAW3B,SAAS,gBAAgB,SAAgC;AACvD,QAAM,WAAW,QAAQ,OAAO;AAChC,MAAI,aAAa,SAAS;AACxB,WAAO,0CAA0C,OAAO;AAAA,EAC1D;AACA,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,WAAO,2BAA2B,QAAQ;AAAA,EAC5C;AACA,SAAO;AACT;AAKA,SAAS,gBAAgB,SAAgC;AACvD,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,OAAO;AAC9B,QAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UAAU;AAC/D,aAAO,+CAA+C,OAAO,QAAQ;AAAA,IACvE;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO,gBAAgB,OAAO;AAAA,EAChC;AACF;AAEA,eAAsB,gBAAgB,SAAyC;AAC7E,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,SAAS;AACX,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,EAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,EAAE;AAAA,EACjF;AAEA,QAAM,EAAE,WAAW,IAAI,MAAM,OAAO,uBAAqB;AACzD,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,yBAAyB;AAClE,QAAM,EAAE,cAAc,IAAI,MAAM,OAAO,uBAA6B;AAEpE,QAAM,SAAS,MAAM,WAAW,OAAO;AACvC,QAAM,WAAW,IAAI,gBAAgB;AACrC,WAAS,SAAS,IAAI,cAAc,CAAC;AAErC,QAAM,UAAU,MAAM,SAAS,OAAO,EAAE,QAAQ,QAAQ,CAAC;AACzD,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,SAAS,MAAM,CAAC,EAAE,CAAC;AAAA,EACpE;AACF;AAEA,eAAsB,eACpB,SACA,SACA,UACwB;AACxB,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,SAAS;AACX,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,EAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,EAAE;AAAA,EACjF;AAEA,QAAM,SAAS,gBAAgB,OAAO;AACtC,MAAI,QAAQ;AACV,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,EAAE,OAAO,OAAO,CAAC,EAAE,CAAC,EAAE;AAAA,EAChF;AAEA,QAAM,EAAE,WAAW,IAAI,MAAM,OAAO,uBAAqB;AACzD,QAAM,EAAE,cAAc,IAAI,MAAM,OAAO,uBAAsB;AAC7D,QAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,8BAAoC;AAClF,QAAM,EAAE,wBAAwB,IAAI,MAAM,OAAO,uBAA6B;AAC9E,QAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,4BAAkC;AAE9E,QAAM,SAAS,MAAM,WAAW,OAAO;AAEvC,QAAM,SAAS,IAAI,cAAc,MAAM;AACvC,SAAO,gBAAgB,IAAI,qBAAqB,CAAC;AACjD,SAAO,gBAAgB,IAAI,wBAAwB,CAAC;AACpD,SAAO,gBAAgB,IAAI,mBAAmB,CAAC;AAE/C,QAAM,SAAS,MAAM,OAAO,IAAI;AAAA,IAC9B;AAAA,IACA,WAAW,CAAC,GAAG;AAAA,IACf,WAAW,OAAO,aAAa,CAAC,EAAE,MAAM,WAAW,OAAO,MAAM,QAAQ,IAAI,CAAC;AAAA,IAC7E;AAAA,IACA,QAAQ;AAAA,IACR,SAAS,OAAO,SAAS,WAAW;AAAA,EACtC,CAAC;AAGD,QAAM,cAA+C;AAAA,IACnD,GAAG,OAAO,YAAY,QAAQ,CAAC,MAAM,EAAE,QAAQ;AAAA,IAC/C,GAAG,OAAO,WAAW,QAAQ,CAAC,MAAM,EAAE,QAAQ;AAAA,EAChD;AAEA,SAAO;AAAA,IACL,SAAS;AAAA,MACP;AAAA,QACE,MAAM;AAAA,QACN,MAAM,KAAK;AAAA,UACT;AAAA,YACE,UAAU;AAAA,YACV,MAAM,OAAO;AAAA,YACb,UAAU,OAAO;AAAA,YACjB,cAAc,YAAY;AAAA,UAC5B;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAsB,kBACpB,SACA,QACwB;AACxB,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,SAAS;AACX,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,EAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,EAAE;AAAA,EACjF;AAEA,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,4BAAwB;AACjE,QAAM,UAAU,MAAM,gBAAgB,OAAO;AAE7C,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,MACL,SAAS;AAAA,QACP;AAAA,UACE,MAAM;AAAA,UACN,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,WAAW,QAAQ;AACrB,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE;AAAA,EAC/E;AAGA,QAAM,gBAAgB,QAAQ,QAAQ,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,SAAS,QAAQ,CAAC;AACnF,QAAM,aAAqC,CAAC;AAC5C,aAAW,KAAK,QAAQ,SAAS;AAC/B,eAAW,KAAK,EAAE,UAAU;AAC1B,iBAAW,EAAE,QAAQ,KAAK,WAAW,EAAE,QAAQ,KAAK,KAAK;AAAA,IAC3D;AAAA,EACF;AACA,QAAM,WAAW,QAAQ,QAAQ,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI;AAChE,QAAM,UAAU;AAAA,IACd,kBAAkB,QAAQ,SAAS;AAAA,IACnC,aAAa,QAAQ;AAAA,IACrB,mBAAmB,aAAa;AAAA,IAChC,GAAG,OAAO,QAAQ,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,KAAK,GAAG,KAAK,KAAK,EAAE;AAAA,EAC1E,EAAE,KAAK,IAAI;AAEX,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC,EAAE;AACtD;;;AD9JA,eAAsB,iBAAgC;AACpD,QAAM,SAAS,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,SAAS,WAAW;AAAA,EACtB,CAAC;AAGD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,SAAS,EAAE,OAAO,EAAE,SAAS,6CAA6C;AAAA,IAC5E;AAAA,IACA,OAAO,EAAE,QAAQ,MAAM,gBAAgB,OAAO;AAAA,EAChD;AAGA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,SAAS,EAAE,OAAO,EAAE,SAAS,6CAA6C;AAAA,MAC1E,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,sFAAsF;AAAA,MAC9H,UAAU,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,8BAA8B;AAAA,IAC7E;AAAA,IACA,OAAO,EAAE,SAAS,SAAS,SAAS,MAAM;AAExC,UAAI,MAAM;AACV,UAAI,CAAC,KAAK;AACR,cAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,oCAAkC;AAC9E,cAAM,YAAY,MAAM,mBAAmB,OAAO;AAClD,cAAM,UAAU;AAAA,MAClB;AAEA,UAAI,KAAK;AACP,eAAO,eAAe,SAAS,KAAK,QAAQ;AAAA,MAC9C;AAGA,aAAO,gBAAgB,OAAO;AAAA,IAChC;AAAA,EACF;AAGA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,SAAS,EAAE,OAAO,EAAE,SAAS,6CAA6C;AAAA,MAC1E,QAAQ,EAAE,KAAK,CAAC,QAAQ,SAAS,CAAC,EAAE,QAAQ,SAAS,EAAE,SAAS,0CAA0C;AAAA,IAC5G;AAAA,IACA,OAAO,EAAE,SAAS,OAAO,MAAM,kBAAkB,SAAS,MAAM;AAAA,EAClE;AAGA,QAAM,YAAY,IAAI,qBAAqB;AAC3C,QAAM,OAAO,QAAQ,SAAS;AAChC;","names":[]}
1
+ {"version":3,"sources":["../../src/mcp/server.ts","../../src/mcp/handlers.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { handleSniffScan, handleSniffRun, handleSniffReport, handleSniffDiscover, handleSniffInstall, handleSniffUnified } from './handlers.js';\nimport { getVersion } from '../version.js';\n\nexport async function startMcpServer(): Promise<void> {\n const server = new McpServer({\n name: 'sniff',\n version: getVersion(),\n });\n\n // Tool: sniff -- unified entry point (preferred). Dispatches to the narrow\n // tools below. The narrow tools remain registered for back-compat and to\n // preserve the documented security pattern of scoped capabilities\n // (sniff-qa/DEEP-DIVE.md:1108). Marked deprecated in v0.5, removal planned v0.7.\n server.tool(\n 'sniff',\n 'Unified entry point. Pass { mode: \"scan\" | \"run\" | \"discover\" | \"report\", rootDir, ...} to dispatch. Prefer this over the narrow tools (sniff_scan / sniff_run / sniff_discover / sniff_report) which are kept only for back-compat.',\n {\n mode: z.enum(['scan', 'run', 'discover', 'report']).describe('scan = source only, run = source + browser audit, discover = autonomous E2E, report = load last results'),\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional(),\n headless: z.boolean().optional(),\n format: z.enum(['json', 'summary']).optional(),\n maxScenarios: z.number().int().min(1).max(200).optional(),\n maxVariantsPerScenario: z.number().int().min(0).max(20).optional(),\n maxVariantsPerRun: z.number().int().min(0).max(200).optional(),\n realism: z.enum(['robot', 'careful-user', 'casual-user', 'frustrated-user', 'power-user']).optional(),\n seed: z.number().int().optional(),\n only: z.string().optional(),\n appType: z.array(z.string()).optional(),\n forceAppType: z.string().optional(),\n dryRun: z.boolean().optional(),\n },\n async (args) => handleSniffUnified(args),\n );\n\n // Tool: sniff_scan -- static source analysis (no browser needed)\n server.tool(\n 'sniff_scan',\n 'Scan project source code for bugs. Finds debug statements, placeholder text, dead links, broken imports, hardcoded URLs, and API endpoint issues (missing validation, auth, error handling, secrets). Works offline, no browser or API key needed. Just pass the project path.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n },\n async ({ rootDir }) => handleSniffScan(rootDir),\n );\n\n // Tool: sniff_run -- full audit (source + browser, auto-detects URL)\n server.tool(\n 'sniff_run',\n 'Run a full quality audit: source scan + browser checks (accessibility, visual regression, performance). The URL is optional -- sniff auto-detects running dev servers. If no server is found, runs source scan only. No API key needed.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional().describe('URL of the running app. Optional -- sniff auto-detects localhost servers if omitted.'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n },\n async ({ rootDir, baseUrl, headless }) => {\n // Auto-detect URL if not provided\n let url = baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(rootDir);\n url = detection.url;\n }\n\n if (url) {\n // Gate on Playwright — return structured setup hint instead of\n // silently running `npx playwright install` (MCP stdio transports\n // commonly time out on the ~45s install).\n const { checkPlaywrightBrowsers } = await import('../core/ensure-browsers.js');\n const check = await checkPlaywrightBrowsers();\n if (check.status !== 'installed') {\n return {\n content: [{\n type: 'text',\n text: JSON.stringify({\n needsSetup: 'playwright-chromium',\n installCommand: check.status === 'missing' ? check.installCommand : 'npx playwright install chromium',\n installSizeMb: check.status === 'missing' ? check.installSizeMb : 165,\n hint: 'Run the sniff_install MCP tool, or run the install command manually, then retry.',\n }),\n }],\n };\n }\n return handleSniffRun(rootDir, url, headless);\n }\n\n // No server found -- fall back to source scan only\n return handleSniffScan(rootDir);\n },\n );\n\n // Tool: sniff_discover -- autonomous E2E discovery (scenarios + edge cases)\n server.tool(\n 'sniff_discover',\n 'Run autonomous end-to-end discovery: extract the app domain from source, classify the app type, generate scenarios with edge-case variants, drive them through Playwright, and return a compact summary. Requires a running dev server (baseUrl optional, auto-detected if omitted). Writes HTML/JSON reports to sniff-reports/discovery/.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().optional().describe('URL of the running app. Optional -- sniff auto-detects localhost servers if omitted.'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n maxScenarios: z.number().int().min(1).max(200).optional().describe('Cap total scenarios (default: 50)'),\n maxVariantsPerScenario: z.number().int().min(0).max(20).optional().describe('Cap edge variants per scenario (default: 3)'),\n maxVariantsPerRun: z.number().int().min(0).max(200).optional().describe('Cap edge variants per run (default: 40)'),\n realism: z.enum(['robot', 'careful-user', 'casual-user', 'frustrated-user', 'power-user']).optional().describe('Realism profile (default: robot in CI, casual-user otherwise)'),\n seed: z.number().int().optional().describe('Replay a specific random seed'),\n only: z.string().optional().describe('Filter scenarios by id substring or app type'),\n appType: z.array(z.string()).optional().describe('Filter classifier guesses to these app types (does NOT bypass classification — use forceAppType for that)'),\n forceAppType: z.string().optional().describe('Force a single app type, bypassing the classifier entirely. Use when classification returns blank.'),\n dryRun: z.boolean().optional().describe('Generate scenarios + classify without launching a browser or writing reports. Useful for preview.'),\n },\n async (args) => {\n let url = args.baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(args.rootDir);\n url = detection.url;\n }\n return handleSniffDiscover({\n rootDir: args.rootDir,\n baseUrl: url,\n headless: args.headless,\n ...(args.maxScenarios !== undefined ? { maxScenarios: args.maxScenarios } : {}),\n ...(args.maxVariantsPerScenario !== undefined ? { maxVariantsPerScenario: args.maxVariantsPerScenario } : {}),\n ...(args.maxVariantsPerRun !== undefined ? { maxVariantsPerRun: args.maxVariantsPerRun } : {}),\n ...(args.realism !== undefined ? { realism: args.realism } : {}),\n ...(args.seed !== undefined ? { seed: args.seed } : {}),\n ...(args.only !== undefined ? { only: args.only } : {}),\n ...(args.appType !== undefined ? { appType: args.appType } : {}),\n ...(args.forceAppType !== undefined ? { forceAppType: args.forceAppType } : {}),\n ...(args.dryRun !== undefined ? { dryRun: args.dryRun } : {}),\n });\n },\n );\n\n // Tool: sniff_install -- explicitly install Playwright's Chromium binary.\n // MCP browser tools return `needsSetup: playwright-chromium` instead of\n // silently shelling out (install takes ~45s, transports time out). Call\n // this tool when that happens, then retry the browser tool.\n server.tool(\n 'sniff_install',\n 'Install the Playwright Chromium binary (~165MB, one-time). Run this when sniff_run or sniff_discover returns `needsSetup: playwright-chromium`.',\n {},\n async () => handleSniffInstall(),\n );\n\n // Tool: sniff_report -- load last results\n server.tool(\n 'sniff_report',\n 'Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n format: z.enum(['json', 'summary']).default('summary').describe('Output format: full JSON or text summary'),\n },\n async ({ rootDir, format }) => handleSniffReport(rootDir, format),\n );\n\n // Connect via stdio transport\n const transport = new StdioServerTransport();\n await server.connect(transport);\n}\n","import { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport type { Finding, BrowserFinding } from '../core/types.js';\n\nexport interface McpToolResult {\n [key: string]: unknown;\n content: Array<{ type: 'text'; text: string }>;\n}\n\n/**\n * Validate rootDir is absolute and exists on disk (T-04-15 mitigation).\n */\nfunction validateRootDir(rootDir: string): string | null {\n const resolved = resolve(rootDir);\n if (resolved !== rootDir) {\n return `rootDir must be an absolute path, got: ${rootDir}`;\n }\n if (!existsSync(resolved)) {\n return `rootDir does not exist: ${resolved}`;\n }\n return null;\n}\n\n/**\n * Validate baseUrl is a valid http/https URL (T-04-16 mitigation).\n */\nfunction validateBaseUrl(baseUrl: string): string | null {\n try {\n const parsed = new URL(baseUrl);\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n return `baseUrl must use http or https scheme, got: ${parsed.protocol}`;\n }\n return null;\n } catch {\n return `Invalid URL: ${baseUrl}`;\n }\n}\n\nexport async function handleSniffScan(rootDir: string): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { ScannerRegistry } = await import('../scanners/registry.js');\n const { SourceScanner } = await import('../scanners/source/index.js');\n\n const config = await loadConfig(rootDir);\n const registry = new ScannerRegistry();\n registry.register(new SourceScanner());\n\n const results = await registry.runAll({ config, rootDir });\n return {\n content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],\n };\n}\n\nexport async function handleSniffRun(\n rootDir: string,\n baseUrl: string,\n headless: boolean,\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const urlErr = validateBaseUrl(baseUrl);\n if (urlErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: urlErr }) }] };\n }\n\n const { loadConfig } = await import('../config/loader.js');\n const { BrowserRunner } = await import('../browser/runner.js');\n const { AccessibilityScanner } = await import('../scanners/accessibility/index.js');\n const { VisualRegressionScanner } = await import('../scanners/visual/index.js');\n const { PerformanceScanner } = await import('../scanners/performance/index.js');\n\n const config = await loadConfig(rootDir);\n\n const runner = new BrowserRunner(config);\n runner.registerScanner(new AccessibilityScanner());\n runner.registerScanner(new VisualRegressionScanner());\n runner.registerScanner(new PerformanceScanner());\n\n const result = await runner.run({\n baseUrl,\n testFiles: ['/'],\n viewports: config.viewports ?? [{ name: 'desktop', width: 1280, height: 720 }],\n headless,\n slowMo: 0,\n timeout: config.browser?.timeout ?? 30000,\n });\n\n // Type both groups explicitly to avoid Finding vs BrowserFinding incompatibility\n const allFindings: Array<Finding | BrowserFinding> = [\n ...result.scanResults.flatMap((r) => r.findings),\n ...result.pageVisits.flatMap((v) => v.findings),\n ];\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(\n {\n findings: allFindings,\n urls: result.urls,\n duration: result.duration,\n findingCount: allFindings.length,\n },\n null,\n 2,\n ),\n },\n ],\n };\n}\n\nexport interface SniffDiscoverOptions {\n rootDir: string;\n baseUrl?: string;\n headless?: boolean;\n maxScenarios?: number;\n maxVariantsPerScenario?: number;\n maxVariantsPerRun?: number;\n realism?: 'robot' | 'careful-user' | 'casual-user' | 'frustrated-user' | 'power-user';\n seed?: number;\n only?: string;\n appType?: string[];\n forceAppType?: string;\n dryRun?: boolean;\n}\n\nexport async function handleSniffDiscover(options: SniffDiscoverOptions): Promise<McpToolResult> {\n const rootErr = validateRootDir(options.rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n if (!options.baseUrl && !options.dryRun) {\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify({\n error: 'No baseUrl provided and no local dev server detected. Start your dev server or pass baseUrl.',\n }),\n },\n ],\n };\n }\n\n if (options.baseUrl) {\n const urlErr = validateBaseUrl(options.baseUrl);\n if (urlErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: urlErr }) }] };\n }\n }\n\n // Gate on Playwright install — skip when dryRun since no browser runs.\n if (!options.dryRun) {\n const { checkPlaywrightBrowsers } = await import('../core/ensure-browsers.js');\n const check = await checkPlaywrightBrowsers();\n if (check.status !== 'installed') {\n return {\n content: [{\n type: 'text',\n text: JSON.stringify({\n needsSetup: 'playwright-chromium',\n installCommand: check.status === 'missing' ? check.installCommand : 'npx playwright install chromium',\n installSizeMb: check.status === 'missing' ? check.installSizeMb : 165,\n hint: 'Run the sniff_install MCP tool, or run the install command manually, then retry.',\n }),\n }],\n };\n }\n }\n\n const { discoverCommand } = await import('../cli/commands/discover.js');\n const result = await discoverCommand({\n rootDir: options.rootDir,\n ...(options.baseUrl ? { url: options.baseUrl } : {}),\n headless: options.headless ?? true,\n nonInteractive: true,\n json: true,\n ...(options.maxScenarios !== undefined ? { maxScenarios: options.maxScenarios } : {}),\n ...(options.maxVariantsPerScenario !== undefined\n ? { maxVariantsPerScenario: options.maxVariantsPerScenario }\n : {}),\n ...(options.maxVariantsPerRun !== undefined ? { maxVariantsPerRun: options.maxVariantsPerRun } : {}),\n ...(options.realism !== undefined ? { realism: options.realism } : {}),\n ...(options.seed !== undefined ? { seed: options.seed } : {}),\n ...(options.only !== undefined ? { only: options.only } : {}),\n ...(options.appType !== undefined ? { appType: options.appType } : {}),\n ...(options.forceAppType !== undefined ? { forceAppType: options.forceAppType } : {}),\n ...(options.dryRun ? { dryRun: true } : {}),\n });\n\n const reports: { html?: string; json?: string; junit?: string } = {};\n for (const p of result.savedPaths) {\n if (p.endsWith('.html')) reports.html = p;\n else if (p.endsWith('.xml')) reports.junit = p;\n else if (p.endsWith('.json')) reports.json = p;\n }\n const summary = {\n baseUrl: result.baseUrl,\n detectedFrom: result.detectedFrom,\n stats: result.report.stats,\n topAppType: result.report.appTypeGuesses[0]?.type,\n topAppConfidence: result.report.appTypeGuesses[0]?.confidence,\n classificationBreakdown: result.report.classificationBreakdown,\n ...(result.dryRun ? { dryRun: result.dryRun } : {}),\n reports,\n savedPaths: result.savedPaths,\n failedScenarios: result.report.scenarios\n .filter((s) => s.status === 'fail' && s.quarantined !== true)\n .map((s) => ({\n id: s.scenario.id,\n name: s.scenario.name,\n failureReason: s.steps.find((step) => step.status === 'fail')?.failureReason,\n })),\n exitCode: result.exitCode,\n };\n\n return {\n content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],\n };\n}\n\nexport interface SniffUnifiedOptions {\n mode: 'scan' | 'run' | 'discover' | 'report';\n rootDir: string;\n baseUrl?: string;\n headless?: boolean;\n format?: 'json' | 'summary';\n maxScenarios?: number;\n maxVariantsPerScenario?: number;\n maxVariantsPerRun?: number;\n realism?: 'robot' | 'careful-user' | 'casual-user' | 'frustrated-user' | 'power-user';\n seed?: number;\n only?: string;\n appType?: string[];\n forceAppType?: string;\n dryRun?: boolean;\n}\n\n/**\n * Dispatch for the unified `sniff` MCP tool. Normalizes the discriminated\n * union input and calls through to the narrow handlers. No new capabilities —\n * this is a UX wrapper only, preserving the security pattern of scoped tools.\n */\nexport async function handleSniffUnified(options: SniffUnifiedOptions): Promise<McpToolResult> {\n switch (options.mode) {\n case 'scan':\n return handleSniffScan(options.rootDir);\n case 'run': {\n let url = options.baseUrl;\n if (!url) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(options.rootDir);\n url = detection.url;\n }\n if (!url) return handleSniffScan(options.rootDir);\n return handleSniffRun(options.rootDir, url, options.headless ?? true);\n }\n case 'discover': {\n let url = options.baseUrl;\n if (!url && !options.dryRun) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(options.rootDir);\n url = detection.url;\n }\n return handleSniffDiscover({\n rootDir: options.rootDir,\n ...(url ? { baseUrl: url } : {}),\n headless: options.headless ?? true,\n ...(options.maxScenarios !== undefined ? { maxScenarios: options.maxScenarios } : {}),\n ...(options.maxVariantsPerScenario !== undefined ? { maxVariantsPerScenario: options.maxVariantsPerScenario } : {}),\n ...(options.maxVariantsPerRun !== undefined ? { maxVariantsPerRun: options.maxVariantsPerRun } : {}),\n ...(options.realism !== undefined ? { realism: options.realism } : {}),\n ...(options.seed !== undefined ? { seed: options.seed } : {}),\n ...(options.only !== undefined ? { only: options.only } : {}),\n ...(options.appType !== undefined ? { appType: options.appType } : {}),\n ...(options.forceAppType !== undefined ? { forceAppType: options.forceAppType } : {}),\n ...(options.dryRun ? { dryRun: true } : {}),\n });\n }\n case 'report':\n return handleSniffReport(options.rootDir, options.format ?? 'summary');\n }\n}\n\nexport async function handleSniffInstall(): Promise<McpToolResult> {\n const { installPlaywrightBrowsers } = await import('../core/ensure-browsers.js');\n const result = await installPlaywrightBrowsers();\n return {\n content: [{\n type: 'text',\n text: JSON.stringify(\n result.status === 'ok'\n ? { status: 'installed', browser: 'chromium' }\n : { status: 'failed', error: result.error, hint: 'Run `npx playwright install chromium` manually for full error output.' },\n ),\n }],\n };\n}\n\nexport async function handleSniffReport(\n rootDir: string,\n format: 'json' | 'summary',\n): Promise<McpToolResult> {\n const rootErr = validateRootDir(rootDir);\n if (rootErr) {\n return { content: [{ type: 'text', text: JSON.stringify({ error: rootErr }) }] };\n }\n\n const { loadLastResults } = await import('../core/persistence.js');\n const results = await loadLastResults(rootDir);\n\n if (!results) {\n return {\n content: [\n {\n type: 'text',\n text: 'No previous sniff results found. Run sniff_scan or sniff_run first.',\n },\n ],\n };\n }\n\n if (format === 'json') {\n return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };\n }\n\n // Summary format\n const totalFindings = results.results.reduce((sum, r) => sum + r.findings.length, 0);\n const bySeverity: Record<string, number> = {};\n for (const r of results.results) {\n for (const f of r.findings) {\n bySeverity[f.severity] = (bySeverity[f.severity] ?? 0) + 1;\n }\n }\n const scanners = results.results.map((r) => r.scanner).join(', ');\n const summary = [\n `Sniff Results (${results.timestamp})`,\n `Scanners: ${scanners}`,\n `Total findings: ${totalFindings}`,\n ...Object.entries(bySeverity).map(([sev, count]) => ` ${sev}: ${count}`),\n ].join('\\n');\n\n return { content: [{ type: 'text', text: summary }] };\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,270 @@
1
+ // src/discovery/persistence/frontmatter.ts
2
+ var FRONTMATTER_OPEN = "---json";
3
+ var FRONTMATTER_CLOSE = "---";
4
+ function parseJsonFrontmatter(content) {
5
+ const normalized = content.replace(/\r\n/g, "\n");
6
+ if (!normalized.startsWith(FRONTMATTER_OPEN)) {
7
+ return { data: null, body: normalized, error: "missing ---json opening marker" };
8
+ }
9
+ const afterOpen = normalized.slice(FRONTMATTER_OPEN.length);
10
+ if (!afterOpen.startsWith("\n")) {
11
+ return { data: null, body: normalized, error: "expected newline after ---json" };
12
+ }
13
+ const rest = afterOpen.slice(1);
14
+ const closeMatch = rest.match(/\n---(?=\n|$)/);
15
+ if (!closeMatch || closeMatch.index === void 0) {
16
+ return { data: null, body: normalized, error: "missing --- closing marker" };
17
+ }
18
+ const jsonPart = rest.slice(0, closeMatch.index);
19
+ const bodyStart = closeMatch.index + closeMatch[0].length;
20
+ const body = rest.slice(bodyStart).replace(/^\n/, "");
21
+ try {
22
+ const data = JSON.parse(jsonPart);
23
+ return { data, body };
24
+ } catch (err) {
25
+ const message = err instanceof Error ? err.message : String(err);
26
+ return { data: null, body, error: `invalid JSON: ${message}` };
27
+ }
28
+ }
29
+ function serializeJsonFrontmatter(data, body = "") {
30
+ const json = JSON.stringify(data, null, 2);
31
+ const trailing = body ? `
32
+ ${body.replace(/^\n+/, "")}` : "";
33
+ return `${FRONTMATTER_OPEN}
34
+ ${json}
35
+ ${FRONTMATTER_CLOSE}
36
+ ${trailing}`;
37
+ }
38
+
39
+ // src/discovery/persistence/scenario-file.ts
40
+ function bodyForScenario(scenario) {
41
+ const lines = [];
42
+ lines.push(`# ${scenario.name}`, "");
43
+ lines.push("## Purpose", "");
44
+ lines.push(scenario.goal.description, "");
45
+ lines.push(`Goal kind: \`${scenario.goal.kind}\``, `Goal value: \`${scenario.goal.value}\``, "");
46
+ if (scenario.tags.length > 0) {
47
+ lines.push("## Tags", "");
48
+ lines.push(scenario.tags.map((t) => `- \`${t}\``).join("\n"), "");
49
+ }
50
+ lines.push("## Steps", "");
51
+ for (const step of scenario.steps) {
52
+ lines.push(`${step.n}. **${step.intent}** (\`${step.action}\`)`);
53
+ }
54
+ lines.push("");
55
+ lines.push("## Known failure modes", "");
56
+ lines.push("Add observed failure modes here. They are informational only.", "");
57
+ return lines.join("\n");
58
+ }
59
+ function scenarioToMarkdown(scenario) {
60
+ return serializeJsonFrontmatter(scenario, bodyForScenario(scenario));
61
+ }
62
+ function markdownToScenario(content) {
63
+ const { data, error } = parseJsonFrontmatter(content);
64
+ if (!data) return { scenario: null, ...error ? { error } : {} };
65
+ if (typeof data.id !== "string" || !Array.isArray(data.steps)) {
66
+ return { scenario: null, error: "frontmatter missing required Scenario fields" };
67
+ }
68
+ return { scenario: data };
69
+ }
70
+ function scenarioRelativePath(scenario) {
71
+ const suffix = scenario.variant === "happy" ? "happy" : scenario.variant.replace(/[^a-z0-9-]/gi, "-");
72
+ return `${scenario.appType}/${scenario.journey}.${suffix}.scenario.md`;
73
+ }
74
+
75
+ // src/discovery/persistence/hashes.ts
76
+ import { createHash } from "crypto";
77
+ import { readFile, writeFile, mkdir } from "fs/promises";
78
+ import { dirname, join } from "path";
79
+ function hashContent(content) {
80
+ return createHash("sha256").update(content, "utf-8").digest("hex");
81
+ }
82
+ async function loadHashes(generatedDir) {
83
+ const path = join(generatedDir, ".hashes.json");
84
+ try {
85
+ const raw = await readFile(path, "utf-8");
86
+ const parsed = JSON.parse(raw);
87
+ return parsed && typeof parsed === "object" ? parsed : {};
88
+ } catch {
89
+ return {};
90
+ }
91
+ }
92
+ async function saveHashes(generatedDir, hashes) {
93
+ const path = join(generatedDir, ".hashes.json");
94
+ await mkdir(dirname(path), { recursive: true });
95
+ await writeFile(path, JSON.stringify(hashes, null, 2), "utf-8");
96
+ }
97
+ async function currentFileHash(path) {
98
+ try {
99
+ const raw = await readFile(path, "utf-8");
100
+ return hashContent(raw);
101
+ } catch {
102
+ return null;
103
+ }
104
+ }
105
+
106
+ // src/discovery/persistence/writer.ts
107
+ import { mkdir as mkdir2, readFile as readFile2, readdir, rm, stat, writeFile as writeFile2 } from "fs/promises";
108
+ import { dirname as dirname2, join as join2, relative } from "path";
109
+ var GITIGNORE_CONTENTS = "# sniff discovery artifacts\ncache/\nruns/\n";
110
+ async function listGeneratedScenarioFiles(generatedDir) {
111
+ const out = [];
112
+ async function walk(dir) {
113
+ let entries;
114
+ try {
115
+ entries = await readdir(dir, { withFileTypes: true });
116
+ } catch {
117
+ return;
118
+ }
119
+ for (const entry of entries) {
120
+ const abs = join2(dir, entry.name);
121
+ if (entry.isDirectory()) {
122
+ await walk(abs);
123
+ } else if (entry.isFile() && entry.name.endsWith(".scenario.md")) {
124
+ out.push(abs);
125
+ }
126
+ }
127
+ }
128
+ await walk(generatedDir);
129
+ return out;
130
+ }
131
+ async function writeIfChanged(path, content) {
132
+ await mkdir2(dirname2(path), { recursive: true });
133
+ try {
134
+ const existing = await readFile2(path, "utf-8");
135
+ if (existing === content) return false;
136
+ } catch {
137
+ }
138
+ await writeFile2(path, content, "utf-8");
139
+ return true;
140
+ }
141
+ async function ensureGitignore(scenariosDir) {
142
+ const path = join2(scenariosDir, ".gitignore");
143
+ try {
144
+ await stat(path);
145
+ return;
146
+ } catch {
147
+ }
148
+ await mkdir2(scenariosDir, { recursive: true });
149
+ await writeFile2(path, GITIGNORE_CONTENTS, "utf-8");
150
+ }
151
+ async function resolveConflict(conflict, options) {
152
+ if (options.forceRegenerate) return "overwrite";
153
+ if (options.nonInteractive) return "keep";
154
+ if (options.onConflict) return options.onConflict(conflict);
155
+ return "keep";
156
+ }
157
+ async function moveToCustom(generatedPath, customDir, generatedDir) {
158
+ const rel = relative(generatedDir, generatedPath);
159
+ const dest = join2(customDir, rel);
160
+ await mkdir2(dirname2(dest), { recursive: true });
161
+ const content = await readFile2(generatedPath, "utf-8");
162
+ await writeFile2(dest, content, "utf-8");
163
+ return dest;
164
+ }
165
+ async function saveDiscoveryScenarios(options) {
166
+ const scenariosDir = join2(options.rootDir, "sniff-scenarios");
167
+ const generatedDir = join2(scenariosDir, "_generated");
168
+ const customDir = join2(scenariosDir, "custom");
169
+ await mkdir2(generatedDir, { recursive: true });
170
+ await mkdir2(customDir, { recursive: true });
171
+ await ensureGitignore(scenariosDir);
172
+ const hashes = await loadHashes(generatedDir);
173
+ const nextHashes = {};
174
+ const result = {
175
+ scenariosDir,
176
+ generatedDir,
177
+ customDir,
178
+ written: [],
179
+ skippedKept: [],
180
+ movedToCustom: [],
181
+ removed: [],
182
+ conflicts: []
183
+ };
184
+ const intendedPaths = /* @__PURE__ */ new Set();
185
+ for (const scenario of options.scenarios) {
186
+ const rel = scenarioRelativePath(scenario);
187
+ const abs = join2(generatedDir, rel);
188
+ intendedPaths.add(abs);
189
+ const content = scenarioToMarkdown(scenario);
190
+ const newHash = hashContent(content);
191
+ const stored = hashes[rel];
192
+ const currentHash = await currentFileHash(abs);
193
+ if (stored?.userOwned) {
194
+ nextHashes[rel] = { hash: stored.hash, userOwned: true };
195
+ result.skippedKept.push(abs);
196
+ continue;
197
+ }
198
+ if (currentHash && stored && currentHash !== stored.hash) {
199
+ const conflict = {
200
+ path: abs,
201
+ relativePath: rel,
202
+ storedHash: stored.hash,
203
+ currentHash,
204
+ scenarioId: scenario.id
205
+ };
206
+ result.conflicts.push(conflict);
207
+ const action = await resolveConflict(conflict, options);
208
+ if (action === "keep") {
209
+ nextHashes[rel] = { hash: stored.hash, userOwned: true };
210
+ result.skippedKept.push(abs);
211
+ continue;
212
+ }
213
+ if (action === "move-to-custom") {
214
+ const moved = await moveToCustom(abs, customDir, generatedDir);
215
+ result.movedToCustom.push(moved);
216
+ }
217
+ }
218
+ const changed = await writeIfChanged(abs, content);
219
+ if (changed) result.written.push(abs);
220
+ nextHashes[rel] = { hash: newHash };
221
+ }
222
+ const existing = await listGeneratedScenarioFiles(generatedDir);
223
+ for (const abs of existing) {
224
+ if (intendedPaths.has(abs)) continue;
225
+ const rel = relative(generatedDir, abs);
226
+ const stored = hashes[rel];
227
+ if (stored?.userOwned) continue;
228
+ const currentHash = await currentFileHash(abs);
229
+ if (currentHash && stored && currentHash !== stored.hash) {
230
+ const conflict = {
231
+ path: abs,
232
+ relativePath: rel,
233
+ storedHash: stored.hash,
234
+ currentHash,
235
+ scenarioId: "(removed)"
236
+ };
237
+ result.conflicts.push(conflict);
238
+ const action = await resolveConflict(conflict, options);
239
+ if (action === "keep") continue;
240
+ if (action === "move-to-custom") {
241
+ const moved = await moveToCustom(abs, customDir, generatedDir);
242
+ result.movedToCustom.push(moved);
243
+ }
244
+ }
245
+ try {
246
+ await rm(abs);
247
+ result.removed.push(abs);
248
+ } catch {
249
+ }
250
+ }
251
+ const snapshotPath = join2(generatedDir, "snapshot.json");
252
+ const classificationPath = join2(generatedDir, "classification.json");
253
+ await writeIfChanged(snapshotPath, JSON.stringify(options.snapshot, null, 2));
254
+ await writeIfChanged(classificationPath, JSON.stringify(options.guesses, null, 2));
255
+ await saveHashes(generatedDir, nextHashes);
256
+ return result;
257
+ }
258
+ export {
259
+ currentFileHash,
260
+ hashContent,
261
+ loadHashes,
262
+ markdownToScenario,
263
+ parseJsonFrontmatter,
264
+ saveDiscoveryScenarios,
265
+ saveHashes,
266
+ scenarioRelativePath,
267
+ scenarioToMarkdown,
268
+ serializeJsonFrontmatter
269
+ };
270
+ //# sourceMappingURL=persistence-KTCRIGHU.js.map