sniff-qa 0.2.0 → 0.3.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.
- package/README.md +220 -411
- package/dist/chunk-VEI2O6AK.js +34 -0
- package/dist/chunk-VEI2O6AK.js.map +1 -0
- package/dist/cli/index.js +67 -4
- package/dist/cli/index.js.map +1 -1
- package/dist/dev-server-detector-NJ5RN4IC.js +150 -0
- package/dist/dev-server-detector-NJ5RN4IC.js.map +1 -0
- package/dist/fix-R33D34NP.js +110 -0
- package/dist/fix-R33D34NP.js.map +1 -0
- package/dist/mcp/server.js +22 -7
- package/dist/mcp/server.js.map +1 -1
- package/dist/{model-SRPWXU63.js → model-2DTSAX7T.js} +6 -6
- package/dist/model-2DTSAX7T.js.map +1 -0
- package/dist/{repo-analyzer-4OURSITY.js → repo-analyzer-WK5WP7NT.js} +1 -1
- package/dist/{report-E2JZMQED.js → report-WLDV72FM.js} +2 -2
- package/dist/{source-D5KLH46F.js → source-4DOO224X.js} +3 -3
- package/dist/source-4DOO224X.js.map +1 -0
- package/dist/{unified-CQU7PSNJ.js → unified-7RKNG3EI.js} +6 -5
- package/dist/unified-7RKNG3EI.js.map +1 -0
- package/dist/version-FLE7ZHDX.js +7 -0
- package/dist/version-FLE7ZHDX.js.map +1 -0
- package/package.json +1 -1
- package/dist/model-SRPWXU63.js.map +0 -1
- package/dist/source-D5KLH46F.js.map +0 -1
- package/dist/unified-CQU7PSNJ.js.map +0 -1
- /package/dist/{repo-analyzer-4OURSITY.js.map → repo-analyzer-WK5WP7NT.js.map} +0 -0
- /package/dist/{report-E2JZMQED.js.map → report-WLDV72FM.js.map} +0 -0
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
// src/version.ts
|
|
2
|
+
import { readFileSync } from "fs";
|
|
3
|
+
import { join, dirname } from "path";
|
|
4
|
+
import { fileURLToPath } from "url";
|
|
5
|
+
var _version = "";
|
|
6
|
+
function getVersion() {
|
|
7
|
+
if (_version) return _version;
|
|
8
|
+
try {
|
|
9
|
+
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
10
|
+
const paths = [
|
|
11
|
+
join(__dirname, "..", "package.json"),
|
|
12
|
+
join(__dirname, "..", "..", "package.json")
|
|
13
|
+
];
|
|
14
|
+
for (const p of paths) {
|
|
15
|
+
try {
|
|
16
|
+
const pkg = JSON.parse(readFileSync(p, "utf-8"));
|
|
17
|
+
if (pkg.version) {
|
|
18
|
+
_version = pkg.version;
|
|
19
|
+
return _version;
|
|
20
|
+
}
|
|
21
|
+
} catch {
|
|
22
|
+
continue;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
} catch {
|
|
26
|
+
}
|
|
27
|
+
_version = "0.0.0";
|
|
28
|
+
return _version;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export {
|
|
32
|
+
getVersion
|
|
33
|
+
};
|
|
34
|
+
//# sourceMappingURL=chunk-VEI2O6AK.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/version.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Single source of truth for the version string.\n * Reads from package.json at build time via the bundled constant,\n * or falls back to reading package.json at runtime.\n */\nlet _version = '';\n\nexport function getVersion(): string {\n if (_version) return _version;\n\n try {\n const __dirname = dirname(fileURLToPath(import.meta.url));\n const paths = [\n join(__dirname, '..', 'package.json'),\n join(__dirname, '..', '..', 'package.json'),\n ];\n\n for (const p of paths) {\n try {\n const pkg = JSON.parse(readFileSync(p, 'utf-8'));\n if (pkg.version) {\n _version = pkg.version as string;\n return _version;\n }\n } catch {\n continue;\n }\n }\n } catch {\n // fallback\n }\n\n _version = '0.0.0';\n return _version;\n}\n"],"mappings":";AAAA,SAAS,oBAAoB;AAC7B,SAAS,MAAM,eAAe;AAC9B,SAAS,qBAAqB;AAO9B,IAAI,WAAW;AAER,SAAS,aAAqB;AACnC,MAAI,SAAU,QAAO;AAErB,MAAI;AACF,UAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AACxD,UAAM,QAAQ;AAAA,MACZ,KAAK,WAAW,MAAM,cAAc;AAAA,MACpC,KAAK,WAAW,MAAM,MAAM,cAAc;AAAA,IAC5C;AAEA,eAAW,KAAK,OAAO;AACrB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,aAAa,GAAG,OAAO,CAAC;AAC/C,YAAI,IAAI,SAAS;AACf,qBAAW,IAAI;AACf,iBAAO;AAAA,QACT;AAAA,MACF,QAAQ;AACN;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,aAAW;AACX,SAAO;AACT;","names":[]}
|
package/dist/cli/index.js
CHANGED
|
@@ -24,14 +24,27 @@ if (process.argv.includes("--mcp")) {
|
|
|
24
24
|
}
|
|
25
25
|
}
|
|
26
26
|
}
|
|
27
|
+
const { getVersion } = await import("../version-FLE7ZHDX.js");
|
|
27
28
|
const program = new Command();
|
|
28
|
-
program.name("sniff").description("AI-powered QA testing framework").version(
|
|
29
|
+
program.name("sniff").description("AI-powered QA testing framework").version(getVersion());
|
|
29
30
|
program.argument("[target]", "Project directory to scan (default: current directory)").option("--url <url>", "Target URL \u2014 enables full audit (a11y, visual, perf, AI explorer)").option("--ci", "CI mode: headless, JUnit XML, flakiness tracking, no AI exploration").option("--no-browser", "Force source-only scan even if URL is configured").option("--no-explore", "Skip AI exploration (browser tests still run)").option("--max-steps <n>", "Cap AI exploration steps (default: 50)").option("--no-headless", "Show the browser window").option("--format <formats>", "Report formats: html, json, junit (comma-separated)").option("--fail-on <severities>", "Exit non-zero on these severities (default: critical,high)", "critical,high").option("--json", "Output results as JSON").option("--track-flakes", "Track test flakiness across runs").action(async (target, options) => {
|
|
30
|
-
const { unifiedCommand } = await import("../unified-
|
|
31
|
+
const { unifiedCommand } = await import("../unified-7RKNG3EI.js");
|
|
31
32
|
const { loadConfig } = await import("../loader-QII5CZSX.js");
|
|
32
33
|
const rootDir = target ? (await import("path")).resolve(target) : process.cwd();
|
|
33
34
|
const config = await loadConfig(rootDir);
|
|
34
|
-
|
|
35
|
+
let url = options.url ?? config.browser?.baseUrl;
|
|
36
|
+
if (!url && options.browser !== false) {
|
|
37
|
+
const { detectDevServerUrl } = await import("../dev-server-detector-NJ5RN4IC.js");
|
|
38
|
+
const detection = await detectDevServerUrl(rootDir);
|
|
39
|
+
if (detection.url) {
|
|
40
|
+
url = detection.url;
|
|
41
|
+
if (!options.json) {
|
|
42
|
+
const pc = (await import("picocolors")).default;
|
|
43
|
+
console.log(`${pc.green("[auto]")} Found dev server at ${pc.bold(url)} (${detection.detail})
|
|
44
|
+
`);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
35
48
|
const wantsBrowser = !!url && options.browser !== false;
|
|
36
49
|
const isCi = options.ci || !!process.env.CI;
|
|
37
50
|
const wantsExplore = wantsBrowser && options.explore !== false && !isCi;
|
|
@@ -60,13 +73,63 @@ if (process.argv.includes("--mcp")) {
|
|
|
60
73
|
await ciCommand(options);
|
|
61
74
|
});
|
|
62
75
|
program.command("report").description("View last scan results").option("--json", "Output as JSON").option("--format <formats>", "Regenerate report in specified formats (comma-separated: html,json,junit)").option("--output <dir>", "Output directory for regenerated reports").action(async (options) => {
|
|
63
|
-
const { reportCommand } = await import("../report-
|
|
76
|
+
const { reportCommand } = await import("../report-WLDV72FM.js");
|
|
64
77
|
await reportCommand(options);
|
|
65
78
|
});
|
|
66
79
|
program.command("update-baselines").description("Update visual regression baselines").option("--yes", "Skip confirmation prompt").action(async (options) => {
|
|
67
80
|
const { updateBaselinesCommand } = await import("../update-baselines-MDTCFO2U.js");
|
|
68
81
|
await updateBaselinesCommand(options);
|
|
69
82
|
});
|
|
83
|
+
program.command("fix").description("Auto-fix safe issues (removes debugger, console.log/debug/info)").argument("[target]", "Project directory (default: current directory)").option("--check", "Dry run: show what would be fixed without changing files").option("--json", "Output results as JSON").action(async (target, options) => {
|
|
84
|
+
const { fixCommand } = await import("../fix-R33D34NP.js");
|
|
85
|
+
const rootDir = target ? (await import("path")).resolve(target) : process.cwd();
|
|
86
|
+
await fixCommand({ rootDir, dryRun: !!options.check, json: !!options.json });
|
|
87
|
+
});
|
|
88
|
+
program.command("doctor").description("Check your environment: Node.js, Playwright, config, dev server").action(async () => {
|
|
89
|
+
const pc = (await import("picocolors")).default;
|
|
90
|
+
const rootDir = process.cwd();
|
|
91
|
+
console.log(`
|
|
92
|
+
${pc.bold("sniff doctor")}
|
|
93
|
+
`);
|
|
94
|
+
const nodeVersion = process.version;
|
|
95
|
+
const nodeMajor = parseInt(nodeVersion.slice(1), 10);
|
|
96
|
+
const nodeOk = nodeMajor >= 22;
|
|
97
|
+
console.log(` ${nodeOk ? pc.green("OK") : pc.red("!! ")} Node.js ${nodeVersion} ${nodeOk ? "" : "(need 22+)"}`);
|
|
98
|
+
let playwrightOk = false;
|
|
99
|
+
try {
|
|
100
|
+
const { chromium } = await import("playwright");
|
|
101
|
+
chromium.executablePath();
|
|
102
|
+
playwrightOk = true;
|
|
103
|
+
} catch {
|
|
104
|
+
}
|
|
105
|
+
console.log(` ${playwrightOk ? pc.green("OK") : pc.yellow("--")} Playwright ${playwrightOk ? "installed" : "not installed (auto-installs on first browser scan)"}`);
|
|
106
|
+
const { loadConfig } = await import("../loader-QII5CZSX.js");
|
|
107
|
+
let hasConfig = false;
|
|
108
|
+
try {
|
|
109
|
+
const config = await loadConfig(rootDir);
|
|
110
|
+
hasConfig = !!config.browser?.baseUrl;
|
|
111
|
+
console.log(` ${pc.green("OK")} Config loaded${hasConfig ? ` (baseUrl: ${config.browser?.baseUrl})` : " (defaults)"}`);
|
|
112
|
+
} catch {
|
|
113
|
+
console.log(` ${pc.green("OK")} No config file (using defaults)`);
|
|
114
|
+
}
|
|
115
|
+
const { detectDevServerUrl, getDevCommand } = await import("../dev-server-detector-NJ5RN4IC.js");
|
|
116
|
+
const detection = await detectDevServerUrl(rootDir);
|
|
117
|
+
if (detection.url) {
|
|
118
|
+
console.log(` ${pc.green("OK")} Dev server found at ${pc.bold(detection.url)} (${detection.detail})`);
|
|
119
|
+
} else {
|
|
120
|
+
const devCmd = await getDevCommand(rootDir);
|
|
121
|
+
console.log(` ${pc.yellow("--")} No dev server running${devCmd ? ` (try: ${devCmd})` : ""}`);
|
|
122
|
+
}
|
|
123
|
+
try {
|
|
124
|
+
const { readFile } = await import("fs/promises");
|
|
125
|
+
const { join } = await import("path");
|
|
126
|
+
const pkg = JSON.parse(await readFile(join(rootDir, "package.json"), "utf-8"));
|
|
127
|
+
console.log(` ${pc.green("OK")} package.json found (${pkg.name ?? "unnamed"})`);
|
|
128
|
+
} catch {
|
|
129
|
+
console.log(` ${pc.yellow("--")} No package.json in current directory`);
|
|
130
|
+
}
|
|
131
|
+
console.log("");
|
|
132
|
+
});
|
|
70
133
|
await program.parseAsync();
|
|
71
134
|
}
|
|
72
135
|
//# sourceMappingURL=index.js.map
|
package/dist/cli/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// MCP server mode bypasses CLI entirely\nif (process.argv.includes('--mcp')) {\n const { startMcpServer } = await import('../mcp/server.js');\n await startMcpServer();\n} else {\n const { Command } = await import('commander');\n\n async function ensurePlaywrightBrowsers(): Promise<void> {\n try {\n const { chromium } = await import('playwright');\n chromium.executablePath();\n } catch {\n const pc = (await import('picocolors')).default;\n console.log(pc.yellow('\\nPlaywright browsers not installed.'));\n console.log(pc.dim('Installing Chromium (required for browser testing)...\\n'));\n const { execSync } = await import('node:child_process');\n try {\n execSync('npx playwright install chromium', { stdio: 'inherit' });\n console.log('');\n } catch {\n console.error(pc.red('Failed to install Playwright browsers. Run manually: npx playwright install chromium'));\n process.exit(1);\n }\n }\n }\n\n const program = new Command();\n\n program\n .name('sniff')\n .description('AI-powered QA testing framework')\n .version('0.2.0');\n\n // ── Default command: unified scan ──────────────────────────────\n // `sniff` → source scan only\n // `sniff --url <url>` → everything (source + a11y + visual + perf + AI explore)\n // `sniff --url X --ci` → everything except exploration (deterministic for CI)\n program\n .argument('[target]', 'Project directory to scan (default: current directory)')\n .option('--url <url>', 'Target URL — enables full audit (a11y, visual, perf, AI explorer)')\n .option('--ci', 'CI mode: headless, JUnit XML, flakiness tracking, no AI exploration')\n .option('--no-browser', 'Force source-only scan even if URL is configured')\n .option('--no-explore', 'Skip AI exploration (browser tests still run)')\n .option('--max-steps <n>', 'Cap AI exploration steps (default: 50)')\n .option('--no-headless', 'Show the browser window')\n .option('--format <formats>', 'Report formats: html, json, junit (comma-separated)')\n .option('--fail-on <severities>', 'Exit non-zero on these severities (default: critical,high)', 'critical,high')\n .option('--json', 'Output results as JSON')\n .option('--track-flakes', 'Track test flakiness across runs')\n .action(async (target, options) => {\n const { unifiedCommand } = await import('./commands/unified.js');\n const { loadConfig } = await import('../config/loader.js');\n\n const rootDir = target ? (await import('node:path')).resolve(target) : process.cwd();\n const config = await loadConfig(rootDir);\n\n // URL resolution: flag → config → none\n const url = options.url ?? config.browser?.baseUrl;\n const wantsBrowser = !!url && options.browser !== false;\n\n // Exploration is default-ON when browser tests run, default-OFF in CI\n const isCi = options.ci || !!process.env.CI;\n const wantsExplore = wantsBrowser && options.explore !== false && !isCi;\n\n if (wantsBrowser) {\n await ensurePlaywrightBrowsers();\n }\n\n await unifiedCommand({\n rootDir,\n url: wantsBrowser ? url : undefined,\n explore: wantsExplore,\n maxSteps: options.maxSteps,\n headless: options.headless,\n format: options.format,\n failOn: options.failOn,\n json: options.json,\n ci: options.ci,\n trackFlakes: options.trackFlakes,\n });\n });\n\n // ── Utility commands ───────────────────────────────────────────\n\n program\n .command('init')\n .description('Generate a sniff config file')\n .option('--force', 'Overwrite existing config')\n .action(async (options) => {\n const { initCommand } = await import('./commands/init.js');\n await initCommand(options);\n });\n\n program\n .command('ci')\n .description('Generate a GitHub Actions workflow')\n .option('--output <path>', 'Output path for workflow file', '.github/workflows/sniff.yml')\n .option('--force', 'Overwrite existing workflow file')\n .option('--package-name <name>', 'npm package name for npx command', 'sniff-qa')\n .action(async (options) => {\n const { ciCommand } = await import('./commands/ci.js');\n await ciCommand(options);\n });\n\n program\n .command('report')\n .description('View last scan results')\n .option('--json', 'Output as JSON')\n .option('--format <formats>', 'Regenerate report in specified formats (comma-separated: html,json,junit)')\n .option('--output <dir>', 'Output directory for regenerated reports')\n .action(async (options) => {\n const { reportCommand } = await import('./commands/report.js');\n await reportCommand(options);\n });\n\n program\n .command('update-baselines')\n .description('Update visual regression baselines')\n .option('--yes', 'Skip confirmation prompt')\n .action(async (options) => {\n const { updateBaselinesCommand } = await import('./commands/update-baselines.js');\n await updateBaselinesCommand(options);\n });\n\n await program.parseAsync();\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// MCP server mode bypasses CLI entirely\nif (process.argv.includes('--mcp')) {\n const { startMcpServer } = await import('../mcp/server.js');\n await startMcpServer();\n} else {\n const { Command } = await import('commander');\n\n async function ensurePlaywrightBrowsers(): Promise<void> {\n try {\n const { chromium } = await import('playwright');\n chromium.executablePath();\n } catch {\n const pc = (await import('picocolors')).default;\n console.log(pc.yellow('\\nPlaywright browsers not installed.'));\n console.log(pc.dim('Installing Chromium (required for browser testing)...\\n'));\n const { execSync } = await import('node:child_process');\n try {\n execSync('npx playwright install chromium', { stdio: 'inherit' });\n console.log('');\n } catch {\n console.error(pc.red('Failed to install Playwright browsers. Run manually: npx playwright install chromium'));\n process.exit(1);\n }\n }\n }\n\n const { getVersion } = await import('../version.js');\n\n const program = new Command();\n\n program\n .name('sniff')\n .description('AI-powered QA testing framework')\n .version(getVersion());\n\n // ── Default command: unified scan ──────────────────────────────\n // `sniff` → source scan + auto-detect dev server\n // `sniff --url <url>` → everything (source + a11y + visual + perf + AI explore)\n // `sniff --url X --ci` → everything except exploration (deterministic for CI)\n program\n .argument('[target]', 'Project directory to scan (default: current directory)')\n .option('--url <url>', 'Target URL — enables full audit (a11y, visual, perf, AI explorer)')\n .option('--ci', 'CI mode: headless, JUnit XML, flakiness tracking, no AI exploration')\n .option('--no-browser', 'Force source-only scan even if URL is configured')\n .option('--no-explore', 'Skip AI exploration (browser tests still run)')\n .option('--max-steps <n>', 'Cap AI exploration steps (default: 50)')\n .option('--no-headless', 'Show the browser window')\n .option('--format <formats>', 'Report formats: html, json, junit (comma-separated)')\n .option('--fail-on <severities>', 'Exit non-zero on these severities (default: critical,high)', 'critical,high')\n .option('--json', 'Output results as JSON')\n .option('--track-flakes', 'Track test flakiness across runs')\n .action(async (target, options) => {\n const { unifiedCommand } = await import('./commands/unified.js');\n const { loadConfig } = await import('../config/loader.js');\n\n const rootDir = target ? (await import('node:path')).resolve(target) : process.cwd();\n const config = await loadConfig(rootDir);\n\n // URL resolution: flag → config → auto-detect\n let url = options.url ?? config.browser?.baseUrl;\n\n if (!url && options.browser !== false) {\n const { detectDevServerUrl } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(rootDir);\n if (detection.url) {\n url = detection.url;\n if (!options.json) {\n const pc = (await import('picocolors')).default;\n console.log(`${pc.green('[auto]')} Found dev server at ${pc.bold(url)} (${detection.detail})\\n`);\n }\n }\n }\n\n const wantsBrowser = !!url && options.browser !== false;\n\n // Exploration is default-ON when browser tests run, default-OFF in CI\n const isCi = options.ci || !!process.env.CI;\n const wantsExplore = wantsBrowser && options.explore !== false && !isCi;\n\n if (wantsBrowser) {\n await ensurePlaywrightBrowsers();\n }\n\n await unifiedCommand({\n rootDir,\n url: wantsBrowser ? url : undefined,\n explore: wantsExplore,\n maxSteps: options.maxSteps,\n headless: options.headless,\n format: options.format,\n failOn: options.failOn,\n json: options.json,\n ci: options.ci,\n trackFlakes: options.trackFlakes,\n });\n });\n\n // ── Utility commands ───────────────────────────────────────────\n\n program\n .command('init')\n .description('Generate a sniff config file')\n .option('--force', 'Overwrite existing config')\n .action(async (options) => {\n const { initCommand } = await import('./commands/init.js');\n await initCommand(options);\n });\n\n program\n .command('ci')\n .description('Generate a GitHub Actions workflow')\n .option('--output <path>', 'Output path for workflow file', '.github/workflows/sniff.yml')\n .option('--force', 'Overwrite existing workflow file')\n .option('--package-name <name>', 'npm package name for npx command', 'sniff-qa')\n .action(async (options) => {\n const { ciCommand } = await import('./commands/ci.js');\n await ciCommand(options);\n });\n\n program\n .command('report')\n .description('View last scan results')\n .option('--json', 'Output as JSON')\n .option('--format <formats>', 'Regenerate report in specified formats (comma-separated: html,json,junit)')\n .option('--output <dir>', 'Output directory for regenerated reports')\n .action(async (options) => {\n const { reportCommand } = await import('./commands/report.js');\n await reportCommand(options);\n });\n\n program\n .command('update-baselines')\n .description('Update visual regression baselines')\n .option('--yes', 'Skip confirmation prompt')\n .action(async (options) => {\n const { updateBaselinesCommand } = await import('./commands/update-baselines.js');\n await updateBaselinesCommand(options);\n });\n\n program\n .command('fix')\n .description('Auto-fix safe issues (removes debugger, console.log/debug/info)')\n .argument('[target]', 'Project directory (default: current directory)')\n .option('--check', 'Dry run: show what would be fixed without changing files')\n .option('--json', 'Output results as JSON')\n .action(async (target, options) => {\n const { fixCommand } = await import('./commands/fix.js');\n const rootDir = target ? (await import('node:path')).resolve(target) : process.cwd();\n await fixCommand({ rootDir, dryRun: !!options.check, json: !!options.json });\n });\n\n program\n .command('doctor')\n .description('Check your environment: Node.js, Playwright, config, dev server')\n .action(async () => {\n const pc = (await import('picocolors')).default;\n const rootDir = process.cwd();\n\n console.log(`\\n${pc.bold('sniff doctor')}\\n`);\n\n // Node.js\n const nodeVersion = process.version;\n const nodeMajor = parseInt(nodeVersion.slice(1), 10);\n const nodeOk = nodeMajor >= 22;\n console.log(` ${nodeOk ? pc.green('OK') : pc.red('!! ')} Node.js ${nodeVersion} ${nodeOk ? '' : '(need 22+)'}`);\n\n // Playwright\n let playwrightOk = false;\n try {\n const { chromium } = await import('playwright');\n chromium.executablePath();\n playwrightOk = true;\n } catch { /* not installed */ }\n console.log(` ${playwrightOk ? pc.green('OK') : pc.yellow('--')} Playwright ${playwrightOk ? 'installed' : 'not installed (auto-installs on first browser scan)'}`);\n\n // Config file\n const { loadConfig } = await import('../config/loader.js');\n let hasConfig = false;\n try {\n const config = await loadConfig(rootDir);\n hasConfig = !!config.browser?.baseUrl;\n console.log(` ${pc.green('OK')} Config loaded${hasConfig ? ` (baseUrl: ${config.browser?.baseUrl})` : ' (defaults)'}`);\n } catch {\n console.log(` ${pc.green('OK')} No config file (using defaults)`);\n }\n\n // Dev server detection\n const { detectDevServerUrl, getDevCommand } = await import('../config/dev-server-detector.js');\n const detection = await detectDevServerUrl(rootDir);\n if (detection.url) {\n console.log(` ${pc.green('OK')} Dev server found at ${pc.bold(detection.url)} (${detection.detail})`);\n } else {\n const devCmd = await getDevCommand(rootDir);\n console.log(` ${pc.yellow('--')} No dev server running${devCmd ? ` (try: ${devCmd})` : ''}`);\n }\n\n // Package.json\n try {\n const { readFile } = await import('node:fs/promises');\n const { join } = await import('node:path');\n const pkg = JSON.parse(await readFile(join(rootDir, 'package.json'), 'utf-8'));\n console.log(` ${pc.green('OK')} package.json found (${pkg.name ?? 'unnamed'})`);\n } catch {\n console.log(` ${pc.yellow('--')} No package.json in current directory`);\n }\n\n console.log('');\n });\n\n await program.parseAsync();\n}\n"],"mappings":";;;AAGA,IAAI,QAAQ,KAAK,SAAS,OAAO,GAAG;AAClC,QAAM,EAAE,eAAe,IAAI,MAAM,OAAO,kBAAkB;AAC1D,QAAM,eAAe;AACvB,OAAO;AACL,QAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,WAAW;AAE5C,iBAAe,2BAA0C;AACvD,QAAI;AACF,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,YAAY;AAC9C,eAAS,eAAe;AAAA,IAC1B,QAAQ;AACN,YAAM,MAAM,MAAM,OAAO,YAAY,GAAG;AACxC,cAAQ,IAAI,GAAG,OAAO,sCAAsC,CAAC;AAC7D,cAAQ,IAAI,GAAG,IAAI,yDAAyD,CAAC;AAC7E,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,eAAoB;AACtD,UAAI;AACF,iBAAS,mCAAmC,EAAE,OAAO,UAAU,CAAC;AAChE,gBAAQ,IAAI,EAAE;AAAA,MAChB,QAAQ;AACN,gBAAQ,MAAM,GAAG,IAAI,sFAAsF,CAAC;AAC5G,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,EAAE,WAAW,IAAI,MAAM,OAAO,wBAAe;AAEnD,QAAM,UAAU,IAAI,QAAQ;AAE5B,UACG,KAAK,OAAO,EACZ,YAAY,iCAAiC,EAC7C,QAAQ,WAAW,CAAC;AAMvB,UACG,SAAS,YAAY,wDAAwD,EAC7E,OAAO,eAAe,wEAAmE,EACzF,OAAO,QAAQ,qEAAqE,EACpF,OAAO,gBAAgB,kDAAkD,EACzE,OAAO,gBAAgB,+CAA+C,EACtE,OAAO,mBAAmB,wCAAwC,EAClE,OAAO,iBAAiB,yBAAyB,EACjD,OAAO,sBAAsB,qDAAqD,EAClF,OAAO,0BAA0B,8DAA8D,eAAe,EAC9G,OAAO,UAAU,wBAAwB,EACzC,OAAO,kBAAkB,kCAAkC,EAC3D,OAAO,OAAO,QAAQ,YAAY;AACjC,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,wBAAuB;AAC/D,UAAM,EAAE,WAAW,IAAI,MAAM,OAAO,uBAAqB;AAEzD,UAAM,UAAU,UAAU,MAAM,OAAO,MAAW,GAAG,QAAQ,MAAM,IAAI,QAAQ,IAAI;AACnF,UAAM,SAAS,MAAM,WAAW,OAAO;AAGvC,QAAI,MAAM,QAAQ,OAAO,OAAO,SAAS;AAEzC,QAAI,CAAC,OAAO,QAAQ,YAAY,OAAO;AACrC,YAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,oCAAkC;AAC9E,YAAM,YAAY,MAAM,mBAAmB,OAAO;AAClD,UAAI,UAAU,KAAK;AACjB,cAAM,UAAU;AAChB,YAAI,CAAC,QAAQ,MAAM;AACjB,gBAAM,MAAM,MAAM,OAAO,YAAY,GAAG;AACxC,kBAAQ,IAAI,GAAG,GAAG,MAAM,QAAQ,CAAC,wBAAwB,GAAG,KAAK,GAAG,CAAC,KAAK,UAAU,MAAM;AAAA,CAAK;AAAA,QACjG;AAAA,MACF;AAAA,IACF;AAEA,UAAM,eAAe,CAAC,CAAC,OAAO,QAAQ,YAAY;AAGlD,UAAM,OAAO,QAAQ,MAAM,CAAC,CAAC,QAAQ,IAAI;AACzC,UAAM,eAAe,gBAAgB,QAAQ,YAAY,SAAS,CAAC;AAEnE,QAAI,cAAc;AAChB,YAAM,yBAAyB;AAAA,IACjC;AAEA,UAAM,eAAe;AAAA,MACnB;AAAA,MACA,KAAK,eAAe,MAAM;AAAA,MAC1B,SAAS;AAAA,MACT,UAAU,QAAQ;AAAA,MAClB,UAAU,QAAQ;AAAA,MAClB,QAAQ,QAAQ;AAAA,MAChB,QAAQ,QAAQ;AAAA,MAChB,MAAM,QAAQ;AAAA,MACd,IAAI,QAAQ;AAAA,MACZ,aAAa,QAAQ;AAAA,IACvB,CAAC;AAAA,EACH,CAAC;AAIH,UACG,QAAQ,MAAM,EACd,YAAY,8BAA8B,EAC1C,OAAO,WAAW,2BAA2B,EAC7C,OAAO,OAAO,YAAY;AACzB,UAAM,EAAE,YAAY,IAAI,MAAM,OAAO,qBAAoB;AACzD,UAAM,YAAY,OAAO;AAAA,EAC3B,CAAC;AAEH,UACG,QAAQ,IAAI,EACZ,YAAY,oCAAoC,EAChD,OAAO,mBAAmB,iCAAiC,6BAA6B,EACxF,OAAO,WAAW,kCAAkC,EACpD,OAAO,yBAAyB,oCAAoC,UAAU,EAC9E,OAAO,OAAO,YAAY;AACzB,UAAM,EAAE,UAAU,IAAI,MAAM,OAAO,mBAAkB;AACrD,UAAM,UAAU,OAAO;AAAA,EACzB,CAAC;AAEH,UACG,QAAQ,QAAQ,EAChB,YAAY,wBAAwB,EACpC,OAAO,UAAU,gBAAgB,EACjC,OAAO,sBAAsB,2EAA2E,EACxG,OAAO,kBAAkB,0CAA0C,EACnE,OAAO,OAAO,YAAY;AACzB,UAAM,EAAE,cAAc,IAAI,MAAM,OAAO,uBAAsB;AAC7D,UAAM,cAAc,OAAO;AAAA,EAC7B,CAAC;AAEH,UACG,QAAQ,kBAAkB,EAC1B,YAAY,oCAAoC,EAChD,OAAO,SAAS,0BAA0B,EAC1C,OAAO,OAAO,YAAY;AACzB,UAAM,EAAE,uBAAuB,IAAI,MAAM,OAAO,iCAAgC;AAChF,UAAM,uBAAuB,OAAO;AAAA,EACtC,CAAC;AAEH,UACG,QAAQ,KAAK,EACb,YAAY,iEAAiE,EAC7E,SAAS,YAAY,gDAAgD,EACrE,OAAO,WAAW,0DAA0D,EAC5E,OAAO,UAAU,wBAAwB,EACzC,OAAO,OAAO,QAAQ,YAAY;AACjC,UAAM,EAAE,WAAW,IAAI,MAAM,OAAO,oBAAmB;AACvD,UAAM,UAAU,UAAU,MAAM,OAAO,MAAW,GAAG,QAAQ,MAAM,IAAI,QAAQ,IAAI;AACnF,UAAM,WAAW,EAAE,SAAS,QAAQ,CAAC,CAAC,QAAQ,OAAO,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC;AAAA,EAC7E,CAAC;AAEH,UACG,QAAQ,QAAQ,EAChB,YAAY,iEAAiE,EAC7E,OAAO,YAAY;AAClB,UAAM,MAAM,MAAM,OAAO,YAAY,GAAG;AACxC,UAAM,UAAU,QAAQ,IAAI;AAE5B,YAAQ,IAAI;AAAA,EAAK,GAAG,KAAK,cAAc,CAAC;AAAA,CAAI;AAG5C,UAAM,cAAc,QAAQ;AAC5B,UAAM,YAAY,SAAS,YAAY,MAAM,CAAC,GAAG,EAAE;AACnD,UAAM,SAAS,aAAa;AAC5B,YAAQ,IAAI,KAAK,SAAS,GAAG,MAAM,IAAI,IAAI,GAAG,IAAI,MAAM,CAAC,YAAY,WAAW,IAAI,SAAS,KAAK,YAAY,EAAE;AAGhH,QAAI,eAAe;AACnB,QAAI;AACF,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,YAAY;AAC9C,eAAS,eAAe;AACxB,qBAAe;AAAA,IACjB,QAAQ;AAAA,IAAsB;AAC9B,YAAQ,IAAI,KAAK,eAAe,GAAG,MAAM,IAAI,IAAI,GAAG,OAAO,IAAI,CAAC,eAAe,eAAe,cAAc,qDAAqD,EAAE;AAGnK,UAAM,EAAE,WAAW,IAAI,MAAM,OAAO,uBAAqB;AACzD,QAAI,YAAY;AAChB,QAAI;AACF,YAAM,SAAS,MAAM,WAAW,OAAO;AACvC,kBAAY,CAAC,CAAC,OAAO,SAAS;AAC9B,cAAQ,IAAI,KAAK,GAAG,MAAM,IAAI,CAAC,iBAAiB,YAAY,cAAc,OAAO,SAAS,OAAO,MAAM,aAAa,EAAE;AAAA,IACxH,QAAQ;AACN,cAAQ,IAAI,KAAK,GAAG,MAAM,IAAI,CAAC,kCAAkC;AAAA,IACnE;AAGA,UAAM,EAAE,oBAAoB,cAAc,IAAI,MAAM,OAAO,oCAAkC;AAC7F,UAAM,YAAY,MAAM,mBAAmB,OAAO;AAClD,QAAI,UAAU,KAAK;AACjB,cAAQ,IAAI,KAAK,GAAG,MAAM,IAAI,CAAC,wBAAwB,GAAG,KAAK,UAAU,GAAG,CAAC,KAAK,UAAU,MAAM,GAAG;AAAA,IACvG,OAAO;AACL,YAAM,SAAS,MAAM,cAAc,OAAO;AAC1C,cAAQ,IAAI,KAAK,GAAG,OAAO,IAAI,CAAC,yBAAyB,SAAS,UAAU,MAAM,MAAM,EAAE,EAAE;AAAA,IAC9F;AAGA,QAAI;AACF,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,aAAkB;AACpD,YAAM,EAAE,KAAK,IAAI,MAAM,OAAO,MAAW;AACzC,YAAM,MAAM,KAAK,MAAM,MAAM,SAAS,KAAK,SAAS,cAAc,GAAG,OAAO,CAAC;AAC7E,cAAQ,IAAI,KAAK,GAAG,MAAM,IAAI,CAAC,wBAAwB,IAAI,QAAQ,SAAS,GAAG;AAAA,IACjF,QAAQ;AACN,cAAQ,IAAI,KAAK,GAAG,OAAO,IAAI,CAAC,uCAAuC;AAAA,IACzE;AAEA,YAAQ,IAAI,EAAE;AAAA,EAChB,CAAC;AAEH,QAAM,QAAQ,WAAW;AAC3B;","names":[]}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
// src/config/dev-server-detector.ts
|
|
2
|
+
import { readFile } from "fs/promises";
|
|
3
|
+
import { join } from "path";
|
|
4
|
+
var FRAMEWORK_PORTS = {
|
|
5
|
+
nextjs: [3e3, 3001],
|
|
6
|
+
vite: [5173, 5174],
|
|
7
|
+
svelte: [5173, 5174],
|
|
8
|
+
vue: [5173, 5174, 8080],
|
|
9
|
+
react: [3e3, 5173],
|
|
10
|
+
angular: [4200],
|
|
11
|
+
astro: [4321],
|
|
12
|
+
remix: [3e3],
|
|
13
|
+
nuxt: [3e3]
|
|
14
|
+
};
|
|
15
|
+
var DEV_SCRIPT_PATTERNS = [
|
|
16
|
+
{ pattern: /\bnext\s+dev\b/, ports: [3e3] },
|
|
17
|
+
{ pattern: /\bvite\b/, ports: [5173] },
|
|
18
|
+
{ pattern: /\bsvelte-kit\s+dev\b/, ports: [5173] },
|
|
19
|
+
{ pattern: /\bnuxi?\s+dev\b/, ports: [3e3] },
|
|
20
|
+
{ pattern: /\bastro\s+dev\b/, ports: [4321] },
|
|
21
|
+
{ pattern: /\bremix\s+dev\b/, ports: [3e3] },
|
|
22
|
+
{ pattern: /\bng\s+serve\b/, ports: [4200] },
|
|
23
|
+
{ pattern: /\bwebpack\s+serve\b/, ports: [8080] },
|
|
24
|
+
{ pattern: /\bparcel\b/, ports: [1234] },
|
|
25
|
+
// Explicit port flags in scripts
|
|
26
|
+
{ pattern: /-p\s+(\d+)/, ports: [] },
|
|
27
|
+
// captured dynamically
|
|
28
|
+
{ pattern: /--port[= ](\d+)/, ports: [] },
|
|
29
|
+
{ pattern: /PORT=(\d+)/, ports: [] }
|
|
30
|
+
];
|
|
31
|
+
var COMMON_PORTS = [3e3, 5173, 8080, 4200, 8e3, 5e3, 4321, 1234];
|
|
32
|
+
async function parseDevScript(rootDir) {
|
|
33
|
+
try {
|
|
34
|
+
const pkg = JSON.parse(await readFile(join(rootDir, "package.json"), "utf-8"));
|
|
35
|
+
const scripts = pkg.scripts ?? {};
|
|
36
|
+
const scriptNames = ["dev", "start", "serve", "dev:local", "start:dev"];
|
|
37
|
+
for (const name of scriptNames) {
|
|
38
|
+
const cmd = scripts[name];
|
|
39
|
+
if (!cmd || typeof cmd !== "string") continue;
|
|
40
|
+
const portMatch = cmd.match(/(?:-p|--port[= ]|PORT=)\s*(\d+)/);
|
|
41
|
+
if (portMatch) {
|
|
42
|
+
return {
|
|
43
|
+
script: name,
|
|
44
|
+
command: cmd,
|
|
45
|
+
ports: [parseInt(portMatch[1], 10)]
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
for (const { pattern, ports } of DEV_SCRIPT_PATTERNS) {
|
|
49
|
+
if (pattern.test(cmd)) {
|
|
50
|
+
return { script: name, command: cmd, ports };
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
|
|
55
|
+
const detectedPorts = [];
|
|
56
|
+
for (const [fw, ports] of Object.entries(FRAMEWORK_PORTS)) {
|
|
57
|
+
const depName = fw === "nextjs" ? "next" : fw === "vue" ? "vue" : fw;
|
|
58
|
+
if (allDeps[depName]) {
|
|
59
|
+
detectedPorts.push(...ports);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
if (detectedPorts.length > 0) {
|
|
63
|
+
return { ports: [...new Set(detectedPorts)] };
|
|
64
|
+
}
|
|
65
|
+
return { ports: [] };
|
|
66
|
+
} catch {
|
|
67
|
+
return { ports: [] };
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
async function isPortAlive(port, hostname = "localhost") {
|
|
71
|
+
const url = `http://${hostname}:${port}`;
|
|
72
|
+
try {
|
|
73
|
+
const controller = new AbortController();
|
|
74
|
+
const timer = setTimeout(() => controller.abort(), 1500);
|
|
75
|
+
const response = await fetch(url, {
|
|
76
|
+
method: "HEAD",
|
|
77
|
+
signal: controller.signal,
|
|
78
|
+
redirect: "follow"
|
|
79
|
+
});
|
|
80
|
+
clearTimeout(timer);
|
|
81
|
+
return response.ok || response.status < 500;
|
|
82
|
+
} catch {
|
|
83
|
+
try {
|
|
84
|
+
const controller = new AbortController();
|
|
85
|
+
const timer = setTimeout(() => controller.abort(), 1500);
|
|
86
|
+
const response = await fetch(url, {
|
|
87
|
+
method: "GET",
|
|
88
|
+
signal: controller.signal,
|
|
89
|
+
redirect: "follow"
|
|
90
|
+
});
|
|
91
|
+
clearTimeout(timer);
|
|
92
|
+
return response.ok || response.status < 500;
|
|
93
|
+
} catch {
|
|
94
|
+
return false;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
async function detectDevServerUrl(rootDir) {
|
|
99
|
+
if (process.env.SNIFF_URL) {
|
|
100
|
+
return { url: process.env.SNIFF_URL, method: "env", detail: "SNIFF_URL" };
|
|
101
|
+
}
|
|
102
|
+
if (process.env.PORT) {
|
|
103
|
+
const port = parseInt(process.env.PORT, 10);
|
|
104
|
+
if (!isNaN(port)) {
|
|
105
|
+
const alive = await isPortAlive(port);
|
|
106
|
+
if (alive) {
|
|
107
|
+
return { url: `http://localhost:${port}`, method: "env", detail: `PORT=${port}` };
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
const devInfo = await parseDevScript(rootDir);
|
|
112
|
+
if (devInfo.ports.length > 0) {
|
|
113
|
+
for (const port of devInfo.ports) {
|
|
114
|
+
if (await isPortAlive(port)) {
|
|
115
|
+
const detail = devInfo.script ? `npm run ${devInfo.script} (port ${port})` : `framework default (port ${port})`;
|
|
116
|
+
return {
|
|
117
|
+
url: `http://localhost:${port}`,
|
|
118
|
+
method: devInfo.script ? "script" : "framework",
|
|
119
|
+
detail
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
for (const port of COMMON_PORTS) {
|
|
125
|
+
if (await isPortAlive(port)) {
|
|
126
|
+
return {
|
|
127
|
+
url: `http://localhost:${port}`,
|
|
128
|
+
method: "probe",
|
|
129
|
+
detail: `found server on port ${port}`
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
return { url: void 0, method: "none" };
|
|
134
|
+
}
|
|
135
|
+
async function getDevCommand(rootDir) {
|
|
136
|
+
try {
|
|
137
|
+
const pkg = JSON.parse(await readFile(join(rootDir, "package.json"), "utf-8"));
|
|
138
|
+
const scripts = pkg.scripts ?? {};
|
|
139
|
+
for (const name of ["dev", "start", "serve"]) {
|
|
140
|
+
if (scripts[name]) return `npm run ${name}`;
|
|
141
|
+
}
|
|
142
|
+
} catch {
|
|
143
|
+
}
|
|
144
|
+
return void 0;
|
|
145
|
+
}
|
|
146
|
+
export {
|
|
147
|
+
detectDevServerUrl,
|
|
148
|
+
getDevCommand
|
|
149
|
+
};
|
|
150
|
+
//# sourceMappingURL=dev-server-detector-NJ5RN4IC.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/config/dev-server-detector.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\n// ---------------------------------------------------------------------------\n// Framework-to-port mappings\n// ---------------------------------------------------------------------------\n\nconst FRAMEWORK_PORTS: Record<string, number[]> = {\n nextjs: [3000, 3001],\n vite: [5173, 5174],\n svelte: [5173, 5174],\n vue: [5173, 5174, 8080],\n react: [3000, 5173],\n angular: [4200],\n astro: [4321],\n remix: [3000],\n nuxt: [3000],\n};\n\n// Dev script patterns that indicate a dev server\nconst DEV_SCRIPT_PATTERNS: Array<{ pattern: RegExp; ports: number[] }> = [\n { pattern: /\\bnext\\s+dev\\b/, ports: [3000] },\n { pattern: /\\bvite\\b/, ports: [5173] },\n { pattern: /\\bsvelte-kit\\s+dev\\b/, ports: [5173] },\n { pattern: /\\bnuxi?\\s+dev\\b/, ports: [3000] },\n { pattern: /\\bastro\\s+dev\\b/, ports: [4321] },\n { pattern: /\\bremix\\s+dev\\b/, ports: [3000] },\n { pattern: /\\bng\\s+serve\\b/, ports: [4200] },\n { pattern: /\\bwebpack\\s+serve\\b/, ports: [8080] },\n { pattern: /\\bparcel\\b/, ports: [1234] },\n // Explicit port flags in scripts\n { pattern: /-p\\s+(\\d+)/, ports: [] }, // captured dynamically\n { pattern: /--port[= ](\\d+)/, ports: [] },\n { pattern: /PORT=(\\d+)/, ports: [] },\n];\n\n// Common ports to try as last resort\nconst COMMON_PORTS = [3000, 5173, 8080, 4200, 8000, 5000, 4321, 1234];\n\n// ---------------------------------------------------------------------------\n// Package.json script parsing\n// ---------------------------------------------------------------------------\n\ninterface DetectedDevInfo {\n script?: string;\n command?: string;\n ports: number[];\n}\n\nasync function parseDevScript(rootDir: string): Promise<DetectedDevInfo> {\n try {\n const pkg = JSON.parse(await readFile(join(rootDir, 'package.json'), 'utf-8'));\n const scripts = pkg.scripts ?? {};\n\n // Try these script names in order\n const scriptNames = ['dev', 'start', 'serve', 'dev:local', 'start:dev'];\n\n for (const name of scriptNames) {\n const cmd = scripts[name];\n if (!cmd || typeof cmd !== 'string') continue;\n\n // Check for explicit port in script\n const portMatch = cmd.match(/(?:-p|--port[= ]|PORT=)\\s*(\\d+)/);\n if (portMatch) {\n return {\n script: name,\n command: cmd,\n ports: [parseInt(portMatch[1], 10)],\n };\n }\n\n // Match against known dev server patterns\n for (const { pattern, ports } of DEV_SCRIPT_PATTERNS) {\n if (pattern.test(cmd)) {\n return { script: name, command: cmd, ports };\n }\n }\n }\n\n // Check dependencies for framework hints\n const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };\n const detectedPorts: number[] = [];\n\n for (const [fw, ports] of Object.entries(FRAMEWORK_PORTS)) {\n const depName = fw === 'nextjs' ? 'next' : fw === 'vue' ? 'vue' : fw;\n if (allDeps[depName]) {\n detectedPorts.push(...ports);\n }\n }\n\n if (detectedPorts.length > 0) {\n return { ports: [...new Set(detectedPorts)] };\n }\n\n return { ports: [] };\n } catch {\n return { ports: [] };\n }\n}\n\n// ---------------------------------------------------------------------------\n// Port health check\n// ---------------------------------------------------------------------------\n\nasync function isPortAlive(port: number, hostname = 'localhost'): Promise<boolean> {\n const url = `http://${hostname}:${port}`;\n try {\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), 1500);\n\n const response = await fetch(url, {\n method: 'HEAD',\n signal: controller.signal,\n redirect: 'follow',\n });\n\n clearTimeout(timer);\n return response.ok || response.status < 500;\n } catch {\n // HEAD might fail, try GET\n try {\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), 1500);\n\n const response = await fetch(url, {\n method: 'GET',\n signal: controller.signal,\n redirect: 'follow',\n });\n\n clearTimeout(timer);\n return response.ok || response.status < 500;\n } catch {\n return false;\n }\n }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nexport interface DetectionResult {\n url: string | undefined;\n method: 'config' | 'env' | 'script' | 'framework' | 'probe' | 'none';\n detail?: string;\n}\n\n/**\n * Auto-detect the dev server URL by checking (in order):\n * 1. SNIFF_URL or PORT environment variables\n * 2. package.json scripts (dev, start, serve)\n * 3. Framework-default ports\n * 4. Common port probing\n */\nexport async function detectDevServerUrl(rootDir: string): Promise<DetectionResult> {\n // 1. Environment variables\n if (process.env.SNIFF_URL) {\n return { url: process.env.SNIFF_URL, method: 'env', detail: 'SNIFF_URL' };\n }\n\n if (process.env.PORT) {\n const port = parseInt(process.env.PORT, 10);\n if (!isNaN(port)) {\n const alive = await isPortAlive(port);\n if (alive) {\n return { url: `http://localhost:${port}`, method: 'env', detail: `PORT=${port}` };\n }\n }\n }\n\n // 2. Parse package.json scripts\n const devInfo = await parseDevScript(rootDir);\n\n // Try script-detected ports first\n if (devInfo.ports.length > 0) {\n for (const port of devInfo.ports) {\n if (await isPortAlive(port)) {\n const detail = devInfo.script\n ? `npm run ${devInfo.script} (port ${port})`\n : `framework default (port ${port})`;\n return {\n url: `http://localhost:${port}`,\n method: devInfo.script ? 'script' : 'framework',\n detail,\n };\n }\n }\n }\n\n // 3. Probe common ports\n for (const port of COMMON_PORTS) {\n if (await isPortAlive(port)) {\n return {\n url: `http://localhost:${port}`,\n method: 'probe',\n detail: `found server on port ${port}`,\n };\n }\n }\n\n // 4. Nothing found\n return { url: undefined, method: 'none' };\n}\n\n/**\n * Get the dev start command from package.json (for suggesting to user).\n */\nexport async function getDevCommand(rootDir: string): Promise<string | undefined> {\n try {\n const pkg = JSON.parse(await readFile(join(rootDir, 'package.json'), 'utf-8'));\n const scripts = pkg.scripts ?? {};\n\n for (const name of ['dev', 'start', 'serve']) {\n if (scripts[name]) return `npm run ${name}`;\n }\n } catch {\n // no package.json\n }\n return undefined;\n}\n"],"mappings":"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","names":[]}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
// src/cli/commands/fix.ts
|
|
2
|
+
import { readFile, writeFile } from "fs/promises";
|
|
3
|
+
import { relative } from "path";
|
|
4
|
+
import fg from "fast-glob";
|
|
5
|
+
var FIXABLE_RULES = [
|
|
6
|
+
{
|
|
7
|
+
id: "debug-debugger",
|
|
8
|
+
pattern: /^\s*debugger\s*;?\s*$/,
|
|
9
|
+
label: "debugger statement"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
id: "debug-console-log",
|
|
13
|
+
pattern: /^\s*console\.(log|debug|info)\s*\(.*\)\s*;?\s*$/,
|
|
14
|
+
label: "console.log/debug/info"
|
|
15
|
+
}
|
|
16
|
+
];
|
|
17
|
+
async function fixCommand(options) {
|
|
18
|
+
const pc = (await import("picocolors")).default;
|
|
19
|
+
if (!options.json) {
|
|
20
|
+
const { getVersion } = await import("./version-FLE7ZHDX.js");
|
|
21
|
+
console.log(`
|
|
22
|
+
${pc.bold("sniff")} v${getVersion()} --fix
|
|
23
|
+
`);
|
|
24
|
+
}
|
|
25
|
+
const files = await fg(["**/*.{ts,tsx,js,jsx}"], {
|
|
26
|
+
cwd: options.rootDir,
|
|
27
|
+
ignore: [
|
|
28
|
+
"**/node_modules/**",
|
|
29
|
+
"**/dist/**",
|
|
30
|
+
"**/build/**",
|
|
31
|
+
"**/.next/**",
|
|
32
|
+
"**/.nuxt/**",
|
|
33
|
+
"**/.svelte-kit/**",
|
|
34
|
+
"**/*.test.*",
|
|
35
|
+
"**/*.spec.*",
|
|
36
|
+
"**/*.config.*"
|
|
37
|
+
],
|
|
38
|
+
absolute: true
|
|
39
|
+
});
|
|
40
|
+
const fixes = [];
|
|
41
|
+
const fileChanges = /* @__PURE__ */ new Map();
|
|
42
|
+
for (const filePath of files) {
|
|
43
|
+
const content = await readFile(filePath, "utf-8");
|
|
44
|
+
const lines = content.split("\n");
|
|
45
|
+
const relPath = relative(options.rootDir, filePath);
|
|
46
|
+
let changed = false;
|
|
47
|
+
const newLines = [];
|
|
48
|
+
for (let i = 0; i < lines.length; i++) {
|
|
49
|
+
const line = lines[i];
|
|
50
|
+
let removed = false;
|
|
51
|
+
for (const rule of FIXABLE_RULES) {
|
|
52
|
+
if (rule.pattern.test(line)) {
|
|
53
|
+
fixes.push({
|
|
54
|
+
filePath: relPath,
|
|
55
|
+
line: i + 1,
|
|
56
|
+
rule: rule.id,
|
|
57
|
+
removed: line.trim()
|
|
58
|
+
});
|
|
59
|
+
removed = true;
|
|
60
|
+
changed = true;
|
|
61
|
+
break;
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
if (!removed) {
|
|
65
|
+
newLines.push(line);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
if (changed) {
|
|
69
|
+
fileChanges.set(filePath, { original: content, fixed: newLines.join("\n") });
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
if (fixes.length === 0) {
|
|
73
|
+
if (options.json) {
|
|
74
|
+
console.log(JSON.stringify({ fixes: [], filesChanged: 0 }));
|
|
75
|
+
} else {
|
|
76
|
+
console.log(`${pc.green("No auto-fixable issues found.")} Your code is clean.
|
|
77
|
+
`);
|
|
78
|
+
}
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
if (options.json) {
|
|
82
|
+
console.log(JSON.stringify({
|
|
83
|
+
dryRun: options.dryRun,
|
|
84
|
+
fixes,
|
|
85
|
+
filesChanged: fileChanges.size
|
|
86
|
+
}, null, 2));
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
const verb = options.dryRun ? "Would remove" : "Removed";
|
|
90
|
+
for (const fix of fixes) {
|
|
91
|
+
const severity = fix.rule === "debug-debugger" ? pc.red("HIGH") : pc.yellow("MED");
|
|
92
|
+
console.log(` ${severity} ${pc.dim(fix.filePath)}:${fix.line} ${verb}: ${pc.strikethrough(fix.removed)}`);
|
|
93
|
+
}
|
|
94
|
+
console.log("");
|
|
95
|
+
if (options.dryRun) {
|
|
96
|
+
console.log(`${pc.yellow("Dry run:")} ${fixes.length} issue${fixes.length !== 1 ? "s" : ""} in ${fileChanges.size} file${fileChanges.size !== 1 ? "s" : ""} would be fixed.`);
|
|
97
|
+
console.log(`${pc.dim("Run without --check to apply fixes.")}
|
|
98
|
+
`);
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
for (const [filePath, { fixed }] of fileChanges) {
|
|
102
|
+
await writeFile(filePath, fixed, "utf-8");
|
|
103
|
+
}
|
|
104
|
+
console.log(`${pc.green("Fixed:")} ${fixes.length} issue${fixes.length !== 1 ? "s" : ""} in ${fileChanges.size} file${fileChanges.size !== 1 ? "s" : ""}.
|
|
105
|
+
`);
|
|
106
|
+
}
|
|
107
|
+
export {
|
|
108
|
+
fixCommand
|
|
109
|
+
};
|
|
110
|
+
//# sourceMappingURL=fix-R33D34NP.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/cli/commands/fix.ts"],"sourcesContent":["import { readFile, writeFile } from 'node:fs/promises';\nimport { relative } from 'node:path';\nimport fg from 'fast-glob';\n\nexport interface FixOptions {\n rootDir: string;\n dryRun: boolean;\n json: boolean;\n}\n\ninterface FixResult {\n filePath: string;\n line: number;\n rule: string;\n removed: string;\n}\n\n// Patterns that are safe to auto-remove (entire line)\nconst FIXABLE_RULES: Array<{\n id: string;\n pattern: RegExp;\n label: string;\n}> = [\n {\n id: 'debug-debugger',\n pattern: /^\\s*debugger\\s*;?\\s*$/,\n label: 'debugger statement',\n },\n {\n id: 'debug-console-log',\n pattern: /^\\s*console\\.(log|debug|info)\\s*\\(.*\\)\\s*;?\\s*$/,\n label: 'console.log/debug/info',\n },\n];\n\nexport async function fixCommand(options: FixOptions): Promise<void> {\n const pc = (await import('picocolors')).default;\n\n if (!options.json) {\n const { getVersion } = await import('../../version.js');\n console.log(`\\n${pc.bold('sniff')} v${getVersion()} --fix\\n`);\n }\n\n const files = await fg(['**/*.{ts,tsx,js,jsx}'], {\n cwd: options.rootDir,\n ignore: [\n '**/node_modules/**', '**/dist/**', '**/build/**',\n '**/.next/**', '**/.nuxt/**', '**/.svelte-kit/**',\n '**/*.test.*', '**/*.spec.*', '**/*.config.*',\n ],\n absolute: true,\n });\n\n const fixes: FixResult[] = [];\n const fileChanges = new Map<string, { original: string; fixed: string }>();\n\n for (const filePath of files) {\n const content = await readFile(filePath, 'utf-8');\n const lines = content.split('\\n');\n const relPath = relative(options.rootDir, filePath);\n let changed = false;\n const newLines: string[] = [];\n\n for (let i = 0; i < lines.length; i++) {\n const line = lines[i];\n let removed = false;\n\n for (const rule of FIXABLE_RULES) {\n if (rule.pattern.test(line)) {\n fixes.push({\n filePath: relPath,\n line: i + 1,\n rule: rule.id,\n removed: line.trim(),\n });\n removed = true;\n changed = true;\n break;\n }\n }\n\n if (!removed) {\n newLines.push(line);\n }\n }\n\n if (changed) {\n fileChanges.set(filePath, { original: content, fixed: newLines.join('\\n') });\n }\n }\n\n if (fixes.length === 0) {\n if (options.json) {\n console.log(JSON.stringify({ fixes: [], filesChanged: 0 }));\n } else {\n console.log(`${pc.green('No auto-fixable issues found.')} Your code is clean.\\n`);\n }\n return;\n }\n\n if (options.json) {\n console.log(JSON.stringify({\n dryRun: options.dryRun,\n fixes,\n filesChanged: fileChanges.size,\n }, null, 2));\n return;\n }\n\n // Show what will be / was fixed\n const verb = options.dryRun ? 'Would remove' : 'Removed';\n\n for (const fix of fixes) {\n const severity = fix.rule === 'debug-debugger' ? pc.red('HIGH') : pc.yellow('MED');\n console.log(` ${severity} ${pc.dim(fix.filePath)}:${fix.line} ${verb}: ${pc.strikethrough(fix.removed)}`);\n }\n\n console.log('');\n\n if (options.dryRun) {\n console.log(`${pc.yellow('Dry run:')} ${fixes.length} issue${fixes.length !== 1 ? 's' : ''} in ${fileChanges.size} file${fileChanges.size !== 1 ? 's' : ''} would be fixed.`);\n console.log(`${pc.dim('Run without --check to apply fixes.')}\\n`);\n return;\n }\n\n // Apply fixes\n for (const [filePath, { fixed }] of fileChanges) {\n await writeFile(filePath, fixed, 'utf-8');\n }\n\n console.log(`${pc.green('Fixed:')} ${fixes.length} issue${fixes.length !== 1 ? 's' : ''} in ${fileChanges.size} file${fileChanges.size !== 1 ? 's' : ''}.\\n`);\n}\n"],"mappings":"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","names":[]}
|
package/dist/mcp/server.js
CHANGED
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
import {
|
|
2
|
+
getVersion
|
|
3
|
+
} from "../chunk-VEI2O6AK.js";
|
|
4
|
+
|
|
1
5
|
// src/mcp/server.ts
|
|
2
6
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
7
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
@@ -34,7 +38,7 @@ async function handleSniffScan(rootDir) {
|
|
|
34
38
|
}
|
|
35
39
|
const { loadConfig } = await import("../loader-QII5CZSX.js");
|
|
36
40
|
const { ScannerRegistry } = await import("../registry-NB5CZB6W.js");
|
|
37
|
-
const { SourceScanner } = await import("../source-
|
|
41
|
+
const { SourceScanner } = await import("../source-4DOO224X.js");
|
|
38
42
|
const config = await loadConfig(rootDir);
|
|
39
43
|
const registry = new ScannerRegistry();
|
|
40
44
|
registry.register(new SourceScanner());
|
|
@@ -133,11 +137,11 @@ async function handleSniffReport(rootDir, format) {
|
|
|
133
137
|
async function startMcpServer() {
|
|
134
138
|
const server = new McpServer({
|
|
135
139
|
name: "sniff",
|
|
136
|
-
version:
|
|
140
|
+
version: getVersion()
|
|
137
141
|
});
|
|
138
142
|
server.tool(
|
|
139
143
|
"sniff_scan",
|
|
140
|
-
"
|
|
144
|
+
"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.",
|
|
141
145
|
{
|
|
142
146
|
rootDir: z.string().describe("Absolute path to the project root directory")
|
|
143
147
|
},
|
|
@@ -145,17 +149,28 @@ async function startMcpServer() {
|
|
|
145
149
|
);
|
|
146
150
|
server.tool(
|
|
147
151
|
"sniff_run",
|
|
148
|
-
"Run
|
|
152
|
+
"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.",
|
|
149
153
|
{
|
|
150
154
|
rootDir: z.string().describe("Absolute path to the project root directory"),
|
|
151
|
-
baseUrl: z.string().describe("
|
|
155
|
+
baseUrl: z.string().optional().describe("URL of the running app. Optional -- sniff auto-detects localhost servers if omitted."),
|
|
152
156
|
headless: z.boolean().default(true).describe("Run browser in headless mode")
|
|
153
157
|
},
|
|
154
|
-
async ({ rootDir, baseUrl, headless }) =>
|
|
158
|
+
async ({ rootDir, baseUrl, headless }) => {
|
|
159
|
+
let url = baseUrl;
|
|
160
|
+
if (!url) {
|
|
161
|
+
const { detectDevServerUrl } = await import("../dev-server-detector-NJ5RN4IC.js");
|
|
162
|
+
const detection = await detectDevServerUrl(rootDir);
|
|
163
|
+
url = detection.url;
|
|
164
|
+
}
|
|
165
|
+
if (url) {
|
|
166
|
+
return handleSniffRun(rootDir, url, headless);
|
|
167
|
+
}
|
|
168
|
+
return handleSniffScan(rootDir);
|
|
169
|
+
}
|
|
155
170
|
);
|
|
156
171
|
server.tool(
|
|
157
172
|
"sniff_report",
|
|
158
|
-
"
|
|
173
|
+
"Get the results from the most recent sniff scan. Returns findings, severities, and fix suggestions.",
|
|
159
174
|
{
|
|
160
175
|
rootDir: z.string().describe("Absolute path to the project root directory"),
|
|
161
176
|
format: z.enum(["json", "summary"]).default("summary").describe("Output format: full JSON or text summary")
|
package/dist/mcp/server.js.map
CHANGED
|
@@ -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';\n\nexport async function startMcpServer(): Promise<void> {\n const server = new McpServer({\n name: 'sniff',\n version: '0.1.0',\n });\n\n // Tool: sniff_scan -- static source analysis\n server.tool(\n 'sniff_scan',\n 'Run static source code analysis on a project and return findings (placeholder text, TODOs, hardcoded strings, broken links)',\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 -- browser E2E + quality scan\n server.tool(\n 'sniff_run',\n 'Run browser-based E2E quality scan (accessibility, visual regression, performance) against a live URL',\n {\n rootDir: z.string().describe('Absolute path to the project root directory'),\n baseUrl: z.string().describe('Base URL of the running application (e.g., http://localhost:3000)'),\n headless: z.boolean().default(true).describe('Run browser in headless mode'),\n },\n async ({ rootDir, baseUrl, headless }) => handleSniffRun(rootDir, baseUrl, headless),\n );\n\n // Tool: sniff_report -- load last results\n server.tool(\n 'sniff_report',\n 'Load the most recent sniff scan results and return a formatted summary',\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":"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","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 } 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":"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","names":[]}
|