sniff-qa 0.8.1 → 0.9.1

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 (176) hide show
  1. package/.claude-plugin/icon.png +0 -0
  2. package/.claude-plugin/plugin.json +9 -2
  3. package/CHANGELOG.md +73 -0
  4. package/NOTICE +7 -4
  5. package/README.md +169 -102
  6. package/THIRD-PARTY-NOTICES.md +1800 -0
  7. package/dist/{accessibility-JXRMWF5Y.js → accessibility-42JOUOGH.js} +8 -2
  8. package/dist/{anthropic-api-ZR3UEB3Z.js → anthropic-api-VSG2X6FS.js} +7 -5
  9. package/dist/assert-budget-WG4BRCLX.js +10 -0
  10. package/dist/{caps-G3ZGJI7B.js → caps-YZPFNPIN.js} +3 -2
  11. package/dist/{chunk-VEI2O6AK.js → chunk-33JL2AB5.js} +14 -6
  12. package/dist/{chunk-7ZOFYET5.js → chunk-3E4W4H6S.js} +36 -16
  13. package/dist/{chunk-EGANHIIE.js → chunk-3NR2K5B3.js} +49 -5
  14. package/dist/chunk-3ROWRVZE.js +422 -0
  15. package/dist/{chunk-MYWWSM3V.js → chunk-3YFE3H23.js} +2 -1
  16. package/dist/{chunk-MMISGY2Q.js → chunk-4F6ZXOPE.js} +2 -1
  17. package/dist/chunk-A4TTASVS.js +27862 -0
  18. package/dist/{chunk-IXDUD2UG.js → chunk-AA744N7E.js} +2 -1
  19. package/dist/chunk-DZMX3VT2.js +267 -0
  20. package/dist/{chunk-NG2IGCAK.js → chunk-FR5QCJLH.js} +2 -1
  21. package/dist/{chunk-GV27IOMC.js → chunk-GC47B6MM.js} +2 -1
  22. package/dist/chunk-HP4TY3UY.js +80 -0
  23. package/dist/chunk-LZAPYYNR.js +4595 -0
  24. package/dist/{chunk-ZM6MGWO4.js → chunk-NBJLMLDA.js} +2 -1
  25. package/dist/chunk-RAGYZ54R.js +15480 -0
  26. package/dist/{chunk-GX36BPK7.js → chunk-RSGFFRXQ.js} +2 -2
  27. package/dist/chunk-SOBWDC35.js +38 -0
  28. package/dist/{chunk-CZKMOAXU.js → chunk-US4HFUCH.js} +3 -2
  29. package/dist/chunk-YM22FEIA.js +5807 -0
  30. package/dist/{ci-ISCWZJD3.js → ci-F6FUXT3O.js} +5 -3
  31. package/dist/{classifier-MWQMQ727.js → classifier-5FQ2FBTO.js} +3 -1
  32. package/dist/{claude-code-ZFTBQXY4.js → claude-code-J43C22IR.js} +7 -5
  33. package/dist/{claude-exploration-provider-QJH6IPYU.js → claude-exploration-provider-EWQNNE7D.js} +4 -3
  34. package/dist/cli/index.js +87 -35
  35. package/dist/compiler-sfc.cjs-JX56AWNS.js +48568 -0
  36. package/dist/crawl-KN7SW753.js +26 -0
  37. package/dist/{crawl-command-RDWGHZC4.js → crawl-command-Y45FIXNK.js} +14 -9
  38. package/dist/{cross-reference-MHNPSLEN.js → cross-reference-XOOBW6UZ.js} +3 -1
  39. package/dist/{dev-server-detector-XQ5AYPDT.js → dev-server-detector-FMFVKDJR.js} +3 -1
  40. package/dist/{discover-QKGMYPHK.js → discover-HA63UA4K.js} +20 -18
  41. package/dist/dist-3CYER35S.js +8 -0
  42. package/dist/{domain-UQ34YE4B.js → domain-FU3WIW64.js} +45 -30
  43. package/dist/{edge-cases-ZADKDZHL.js → edge-cases-B6IV3IKK.js} +3 -1
  44. package/dist/{element-extractor-OZTFBVKZ.js → element-extractor-QAG4MRUO.js} +18 -6
  45. package/dist/engine-AXB5O4ZH.js +39 -0
  46. package/dist/ensure-browsers-TNMHMLRS.js +147 -0
  47. package/dist/errors-NWB25P4K.js +8 -0
  48. package/dist/esm-IMWPYLSN.js +3469 -0
  49. package/dist/{fix-R33D34NP.js → fix-IXOEHAOS.js} +12 -5
  50. package/dist/{flakiness-OLJAY7CS.js → flakiness-7SSSM4SW.js} +3 -2
  51. package/dist/flakiness-CBKV4U54.js +12 -0
  52. package/dist/formatter-N4CC7SCM.js +176 -0
  53. package/dist/{framework-detector-ISSM2Q2I.js → framework-detector-4ZVHNT7N.js} +3 -1
  54. package/dist/generator-GGJYWYI2.js +8 -0
  55. package/dist/index.d.ts +15 -5
  56. package/dist/index.js +9 -6
  57. package/dist/{init-IQKT4ANC.js → init-POX5ZJ6V.js} +4 -2
  58. package/dist/json-4VOVHDQG.js +10 -0
  59. package/dist/{junit-GL44ATRR.js → junit-V24COOSR.js} +3 -1
  60. package/dist/{llm-VJAI6H6G.js → llm-TZ2WZGRZ.js} +3 -1
  61. package/dist/{loader-Z2DUGG5Z.js → loader-AMM63AOJ.js} +12 -3
  62. package/dist/mcp/server.js +13049 -73
  63. package/dist/{model-SP6HJN6J.js → model-BL2AID5Q.js} +6 -5
  64. package/dist/page-hooks-SECSGZR6.js +14 -0
  65. package/dist/{page-state-extractor-GYYLYRFR.js → page-state-extractor-AP4FQVLY.js} +3 -1
  66. package/dist/{performance-7HWKY5O2.js → performance-JVEYVBTV.js} +9 -3
  67. package/dist/{persistence-XLFJ5EY4.js → persistence-SHKJVSIS.js} +5 -4
  68. package/dist/{persistence-KTCRIGHU.js → persistence-SQ6QT3HP.js} +3 -1
  69. package/dist/picocolors-3W2AX5TJ.js +6 -0
  70. package/dist/pixelmatch-GATIVDQX.js +188 -0
  71. package/dist/png-HTC2G4ZG.js +2093 -0
  72. package/dist/{prompt-builder-D3FBH534.js → prompt-builder-EI2BFKLZ.js} +4 -2
  73. package/dist/{provider-BCKFVPTN.js → provider-O3UOALQH.js} +14 -12
  74. package/dist/{quality-run-YAURB242.js → quality-run-CTLX5YA5.js} +12 -10
  75. package/dist/{redaction-CHAIVPCF.js → redaction-QNBV5QZ3.js} +4 -3
  76. package/dist/{registry-5XCXUAYJ.js → registry-JBBTSD7I.js} +3 -1
  77. package/dist/{repo-analyzer-4OURSITY.js → repo-analyzer-4XITIIAF.js} +6 -4
  78. package/dist/{report-SDZWX25B.js → report-4UVJL7QV.js} +3 -1
  79. package/dist/{report-7FQFH4HW.js → report-BOVSPRCR.js} +8 -6
  80. package/dist/{response-parser-PUGNWF7S.js → response-parser-GHVJSYXQ.js} +3 -2
  81. package/dist/{route-discoverer-QBZCRQLJ.js → route-discoverer-ZXYJQIYE.js} +15 -8
  82. package/dist/{runner-RDVVIGBU.js → runner-DOLCFA3S.js} +10 -5
  83. package/dist/{runner-QHSYX7J2.js → runner-MCSDHFLN.js} +12 -7
  84. package/dist/{runner-AXZXNWYH.js → runner-MUBXHOIG.js} +10 -4
  85. package/dist/{scenarios-I7YYVTD2.js → scenarios-T2U6ZDRL.js} +3 -1
  86. package/dist/sdk-FQKA5HSQ.js +7184 -0
  87. package/dist/{source-5LS2B7TN.js → source-T5MHBY5G.js} +14 -7
  88. package/dist/{tiebreak-L5UFNKU2.js → tiebreak-SXBXPT7B.js} +3 -1
  89. package/dist/{unified-YSOTPG5B.js → unified-NUR2X5JV.js} +23 -21
  90. package/dist/{update-baselines-JYKUUIZG.js → update-baselines-TMERPIDV.js} +4 -2
  91. package/dist/version-FEHABGAH.js +10 -0
  92. package/dist/{visual-EUZG2STF.js → visual-XHFPFQFX.js} +5 -3
  93. package/dist/{workflow-template-6DADGPHA.js → workflow-template-7C5CCK67.js} +13 -7
  94. package/dist/{write-report-6RJWN54I.js → write-report-6Q4MXBYD.js} +5 -4
  95. package/package.json +21 -14
  96. package/dist/accessibility-JXRMWF5Y.js.map +0 -1
  97. package/dist/anthropic-api-ZR3UEB3Z.js.map +0 -1
  98. package/dist/assert-budget-NBF3JYM7.js +0 -9
  99. package/dist/assert-budget-NBF3JYM7.js.map +0 -1
  100. package/dist/caps-G3ZGJI7B.js.map +0 -1
  101. package/dist/chunk-7ZOFYET5.js.map +0 -1
  102. package/dist/chunk-CZKMOAXU.js.map +0 -1
  103. package/dist/chunk-EGANHIIE.js.map +0 -1
  104. package/dist/chunk-GV27IOMC.js.map +0 -1
  105. package/dist/chunk-GX36BPK7.js.map +0 -1
  106. package/dist/chunk-IXDUD2UG.js.map +0 -1
  107. package/dist/chunk-MMISGY2Q.js.map +0 -1
  108. package/dist/chunk-MYWWSM3V.js.map +0 -1
  109. package/dist/chunk-NG2IGCAK.js.map +0 -1
  110. package/dist/chunk-VEI2O6AK.js.map +0 -1
  111. package/dist/chunk-ZM6MGWO4.js.map +0 -1
  112. package/dist/ci-ISCWZJD3.js.map +0 -1
  113. package/dist/classifier-MWQMQ727.js.map +0 -1
  114. package/dist/claude-code-ZFTBQXY4.js.map +0 -1
  115. package/dist/claude-exploration-provider-QJH6IPYU.js.map +0 -1
  116. package/dist/cli/index.js.map +0 -1
  117. package/dist/crawl-ZXZRF4Q7.js +0 -15
  118. package/dist/crawl-ZXZRF4Q7.js.map +0 -1
  119. package/dist/crawl-command-RDWGHZC4.js.map +0 -1
  120. package/dist/cross-reference-MHNPSLEN.js.map +0 -1
  121. package/dist/dev-server-detector-XQ5AYPDT.js.map +0 -1
  122. package/dist/discover-QKGMYPHK.js.map +0 -1
  123. package/dist/domain-UQ34YE4B.js.map +0 -1
  124. package/dist/edge-cases-ZADKDZHL.js.map +0 -1
  125. package/dist/element-extractor-OZTFBVKZ.js.map +0 -1
  126. package/dist/ensure-browsers-AYKMLUHV.js +0 -86
  127. package/dist/ensure-browsers-AYKMLUHV.js.map +0 -1
  128. package/dist/errors-RFEOR527.js +0 -7
  129. package/dist/errors-RFEOR527.js.map +0 -1
  130. package/dist/fix-R33D34NP.js.map +0 -1
  131. package/dist/flakiness-OLJAY7CS.js.map +0 -1
  132. package/dist/flakiness-OVC7KGN2.js +0 -11
  133. package/dist/flakiness-OVC7KGN2.js.map +0 -1
  134. package/dist/formatter-HC3LT3VH.js +0 -146
  135. package/dist/formatter-HC3LT3VH.js.map +0 -1
  136. package/dist/framework-detector-ISSM2Q2I.js.map +0 -1
  137. package/dist/generator-HIFV67NI.js +0 -7
  138. package/dist/generator-HIFV67NI.js.map +0 -1
  139. package/dist/index.js.map +0 -1
  140. package/dist/init-IQKT4ANC.js.map +0 -1
  141. package/dist/json-YDWEB33Q.js +0 -8
  142. package/dist/json-YDWEB33Q.js.map +0 -1
  143. package/dist/junit-GL44ATRR.js.map +0 -1
  144. package/dist/llm-VJAI6H6G.js.map +0 -1
  145. package/dist/loader-Z2DUGG5Z.js.map +0 -1
  146. package/dist/mcp/server.js.map +0 -1
  147. package/dist/model-SP6HJN6J.js.map +0 -1
  148. package/dist/page-hooks-6RALVZB5.js +0 -13
  149. package/dist/page-hooks-6RALVZB5.js.map +0 -1
  150. package/dist/page-state-extractor-GYYLYRFR.js.map +0 -1
  151. package/dist/performance-7HWKY5O2.js.map +0 -1
  152. package/dist/persistence-KTCRIGHU.js.map +0 -1
  153. package/dist/persistence-XLFJ5EY4.js.map +0 -1
  154. package/dist/prompt-builder-D3FBH534.js.map +0 -1
  155. package/dist/provider-BCKFVPTN.js.map +0 -1
  156. package/dist/quality-run-YAURB242.js.map +0 -1
  157. package/dist/redaction-CHAIVPCF.js.map +0 -1
  158. package/dist/registry-5XCXUAYJ.js.map +0 -1
  159. package/dist/repo-analyzer-4OURSITY.js.map +0 -1
  160. package/dist/report-7FQFH4HW.js.map +0 -1
  161. package/dist/report-SDZWX25B.js.map +0 -1
  162. package/dist/response-parser-PUGNWF7S.js.map +0 -1
  163. package/dist/route-discoverer-QBZCRQLJ.js.map +0 -1
  164. package/dist/runner-AXZXNWYH.js.map +0 -1
  165. package/dist/runner-QHSYX7J2.js.map +0 -1
  166. package/dist/runner-RDVVIGBU.js.map +0 -1
  167. package/dist/scenarios-I7YYVTD2.js.map +0 -1
  168. package/dist/source-5LS2B7TN.js.map +0 -1
  169. package/dist/tiebreak-L5UFNKU2.js.map +0 -1
  170. package/dist/unified-YSOTPG5B.js.map +0 -1
  171. package/dist/update-baselines-JYKUUIZG.js.map +0 -1
  172. package/dist/version-FLE7ZHDX.js +0 -7
  173. package/dist/version-FLE7ZHDX.js.map +0 -1
  174. package/dist/visual-EUZG2STF.js.map +0 -1
  175. package/dist/workflow-template-6DADGPHA.js.map +0 -1
  176. package/dist/write-report-6RJWN54I.js.map +0 -1
@@ -1,10 +1,13 @@
1
+ import { createRequire as __sniffCreateRequire } from 'node:module'; const require = __sniffCreateRequire(import.meta.url);
2
+ import "./chunk-SOBWDC35.js";
3
+
1
4
  // src/cli/commands/ci.ts
2
5
  async function ciCommand(options) {
3
- const pc = (await import("picocolors")).default;
6
+ const pc = (await import("./picocolors-3W2AX5TJ.js")).default;
4
7
  const { existsSync } = await import("fs");
5
8
  const { mkdir, writeFile } = await import("fs/promises");
6
9
  const { join, dirname } = await import("path");
7
- const { generateGitHubActionsWorkflow, detectPackageManager } = await import("./workflow-template-6DADGPHA.js");
10
+ const { generateGitHubActionsWorkflow, detectPackageManager } = await import("./workflow-template-7C5CCK67.js");
8
11
  const outputPath = options.output ?? ".github/workflows/sniff.yml";
9
12
  if (!outputPath.endsWith(".yml") && !outputPath.endsWith(".yaml")) {
10
13
  console.error(pc.red("Output path must end with .yml or .yaml"));
@@ -49,4 +52,3 @@ ${pc.dim("The workflow runs")} ${pc.bold("npx " + packageName + " --ci")} ${pc.d
49
52
  export {
50
53
  ciCommand
51
54
  };
52
- //# sourceMappingURL=ci-ISCWZJD3.js.map
@@ -1,3 +1,6 @@
1
+ import { createRequire as __sniffCreateRequire } from 'node:module'; const require = __sniffCreateRequire(import.meta.url);
2
+ import "./chunk-SOBWDC35.js";
3
+
1
4
  // src/discovery/classifier/signatures/ecommerce.ts
2
5
  var ecommerce = {
3
6
  type: "ecommerce",
@@ -1698,4 +1701,3 @@ export {
1698
1701
  scoreAllSignatures,
1699
1702
  topAppType
1700
1703
  };
1701
- //# sourceMappingURL=classifier-MWQMQ727.js.map
@@ -1,3 +1,6 @@
1
+ import { createRequire as __sniffCreateRequire } from 'node:module'; const require = __sniffCreateRequire(import.meta.url);
2
+ import "./chunk-SOBWDC35.js";
3
+
1
4
  // src/ai/claude-code.ts
2
5
  import { execFile as execFileCb } from "child_process";
3
6
  import { promisify } from "util";
@@ -9,8 +12,8 @@ var ClaudeCodeProvider = class {
9
12
  this.command = command;
10
13
  }
11
14
  async generateTests(context) {
12
- const { buildSystemPrompt, buildUserPrompt } = await import("./prompt-builder-D3FBH534.js");
13
- const { parseGeneratedTest } = await import("./response-parser-PUGNWF7S.js");
15
+ const { buildSystemPrompt, buildUserPrompt } = await import("./prompt-builder-EI2BFKLZ.js");
16
+ const { parseGeneratedTest } = await import("./response-parser-GHVJSYXQ.js");
14
17
  const systemPrompt = buildSystemPrompt();
15
18
  const userPrompt = buildUserPrompt(context);
16
19
  try {
@@ -32,10 +35,10 @@ var ClaudeCodeProvider = class {
32
35
  return parseGeneratedTest(rawContent, context.route.path);
33
36
  } catch (err) {
34
37
  if (err instanceof Error && "code" in err && err.code === "ENOENT") {
35
- const { SniffError: SniffError2 } = await import("./errors-RFEOR527.js");
38
+ const { SniffError: SniffError2 } = await import("./errors-NWB25P4K.js");
36
39
  throw new SniffError2("CLAUDE_CLI_NOT_FOUND", 'Claude Code CLI not found. Install it from https://claude.ai/download, choose another ai.provider, or set ai.provider to "none".');
37
40
  }
38
- const { SniffError } = await import("./errors-RFEOR527.js");
41
+ const { SniffError } = await import("./errors-NWB25P4K.js");
39
42
  throw new SniffError("CLAUDE_CLI_ERROR", `Claude Code CLI failed: ${err instanceof Error ? err.message : String(err)}`);
40
43
  }
41
44
  }
@@ -43,4 +46,3 @@ var ClaudeCodeProvider = class {
43
46
  export {
44
47
  ClaudeCodeProvider
45
48
  };
46
- //# sourceMappingURL=claude-code-ZFTBQXY4.js.map
@@ -1,6 +1,8 @@
1
+ import { createRequire as __sniffCreateRequire } from 'node:module'; const require = __sniffCreateRequire(import.meta.url);
1
2
  import {
2
3
  selectPayload
3
- } from "./chunk-MMISGY2Q.js";
4
+ } from "./chunk-4F6ZXOPE.js";
5
+ import "./chunk-SOBWDC35.js";
4
6
 
5
7
  // src/exploration/claude-exploration-provider.ts
6
8
  import { execFile as execFileCb } from "child_process";
@@ -25,7 +27,7 @@ Respond with ONLY a JSON object matching this shape:
25
27
  {
26
28
  "action": "click" | "fill" | "navigate" | "scroll" | "done",
27
29
  "selector": "CSS selector for click/fill targets",
28
- "value": "value to fill for fill actions \u2014 use edge-case data like XSS payloads, SQL injection, Unicode, boundary values",
30
+ "value": "value to fill for fill actions; use edge-case data like XSS payloads, SQL injection, Unicode, boundary values",
29
31
  "url": "URL for navigate actions",
30
32
  "reasoning": "why you chose this action"
31
33
  }
@@ -123,4 +125,3 @@ Priorities:
123
125
  export {
124
126
  ClaudeExplorationProvider
125
127
  };
126
- //# sourceMappingURL=claude-exploration-provider-QJH6IPYU.js.map
package/dist/cli/index.js CHANGED
@@ -1,8 +1,9 @@
1
1
  #!/usr/bin/env node
2
+ import { createRequire as __sniffCreateRequire } from 'node:module'; const require = __sniffCreateRequire(import.meta.url);
2
3
 
3
4
  // src/cli/index.ts
4
5
  if (process.argv.includes("--mcp")) {
5
- const { parseCaps, CapsError } = await import("../caps-G3ZGJI7B.js");
6
+ const { parseCaps, CapsError } = await import("../caps-YZPFNPIN.js");
6
7
  let caps;
7
8
  try {
8
9
  caps = parseCaps(process.argv);
@@ -13,20 +14,36 @@ if (process.argv.includes("--mcp")) {
13
14
  const { startMcpServer } = await import("../mcp/server.js");
14
15
  await startMcpServer(caps);
15
16
  } else {
16
- const { Command } = await import("commander");
17
- const { ensurePlaywrightBrowsers } = await import("../ensure-browsers-AYKMLUHV.js");
18
- const { getVersion } = await import("../version-FLE7ZHDX.js");
17
+ const { Command } = await import("../esm-IMWPYLSN.js");
18
+ const { ensurePlaywrightBrowsers } = await import("../ensure-browsers-TNMHMLRS.js");
19
+ const { getVersion } = await import("../version-FEHABGAH.js");
19
20
  const program = new Command();
20
- program.name("sniff").description("AI-powered QA testing framework").version(getVersion());
21
- program.argument("[target]", "Project directory to scan (default: current directory)").option("--url <url>", "Target URL, enables full browser audit (a11y, visual, perf, runtime hooks)").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("--explore", "Run optional AI exploration after browser checks", false).option("--no-explore", "Skip AI exploration (kept for compatibility; exploration is off by default)").option("--max-steps <n>", "Cap AI exploration steps when --explore is used (default: 50)").option("--headed", "Show the browser window (alias for --no-headless)").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("--report", "Write a self-contained HTML report to sniff-reports/sniff-report.html").option("--all", "Show low-confidence findings too (hidden by default)").option("--max-pages <n>", "Max pages to crawl during the flow-walk (default: 25)").option("--no-mobile", "Skip the mobile (375px) responsive pass").option("--storage-state <path>", "Playwright storage-state JSON, so the walk runs as a logged-in user. Cookie and token values from it are redacted from every written report.").option("--track-flakes", "Track test flakiness across runs").option("--discover", "Run autonomous E2E discovery (scenarios + edge cases)").option("--max-scenarios <n>", "Cap total scenarios for discovery (default: 50)").option("--max-variants-per-scenario <n>", "Cap edge variants per scenario (default: 3)").option("--max-variants-per-run <n>", "Cap edge variants per run (default: 40)").option("--realism <profile>", "Discovery realism: robot, careful-user, casual-user, frustrated-user, power-user").option("--seed <n>", "Replay a specific random seed").option("--only <filter>", "Filter discovery scenarios by id substring or app type").option("--app-type <types>", "Filter discovery app types (comma-separated); only generates scenarios for these types if the classifier matches them").option("--force-app-type <type>", "Force a single app type, bypassing the classifier entirely (use when classification returns blank)").option("--no-llm", "Disable LLM-backed discovery polish").option("--non-interactive", "Non-interactive mode for discovery (skips prompts and countdown)").option("--regenerate", "Regenerate sniff-scenarios/ before running (prompts on hand-edits)").option("--regenerate-only", "Regenerate sniff-scenarios/ and exit without running").option("--force-regenerate", "Regenerate sniff-scenarios/ and overwrite hand-edits").option("--verbose", "Print classification breakdown (top 3 guesses + matched signals per dimension)").option("--dry-run", "Discover: generate scenarios + classify without running browser or writing reports").action(async (target, options) => {
21
+ program.name("sniff").description(
22
+ "Walks your running app in a real browser and reports what is broken, with the steps that reproduce it.\nWith no app running it reads your source instead. No API key, no account."
23
+ ).version(getVersion()).addHelpText("after", `
24
+ Start here:
25
+ $ sniff --url http://localhost:3000 walk a running app and print the report
26
+ $ sniff --url http://localhost:3000 --report
27
+ also write sniff-reports/sniff-report.html
28
+ $ sniff scan read the source only, no browser
29
+ $ sniff doctor check Node, the browser and the dev server
30
+ $ sniff install download the browser engine and Chromium now
31
+
32
+ Exit codes:
33
+ 0 no finding reached the --fail-on severities (default: critical,high)
34
+ 1 a finding reached them, an assert budget was breached, or sniff could not run
35
+
36
+ A walk clicks buttons and submits forms. Point it at a dev or staging app.
37
+ Docs: https://github.com/Aboudjem/sniff#readme`);
38
+ program.argument("[target]", "Project directory to scan (default: current directory)").option("--url <url>", "URL of the running app to walk (default: the dev server found on a common port)").option("--ci", "CI mode: headless and non-interactive").option("--no-browser", "Force source-only scan even if URL is configured").option("--explore", "Run optional AI exploration after browser checks", false).option("--no-explore", "Skip AI exploration (kept for compatibility; exploration is off by default)").option("--max-steps <n>", "Cap AI exploration steps when --explore is used (default: 50)").option("--headed", "Show the browser window (alias for --no-headless)").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", "critical,high").option("--json", "Output results as JSON").option("--report", "Write a self-contained HTML report to sniff-reports/sniff-report.html").option("--all", "Show low-confidence findings too (hidden by default)").option("--max-pages <n>", "Max pages to crawl during the flow-walk (default: 25)").option("--no-mobile", "Skip the mobile (375px) responsive pass").option("--storage-state <path>", "Playwright storage-state JSON, so the walk runs as a logged-in user. Cookie and token values from it are redacted from every written report.").option("--track-flakes", "Track test flakiness across runs").option("--discover", "Run autonomous E2E discovery (scenarios + edge cases)").option("--max-scenarios <n>", "Cap total scenarios for discovery (default: 50)").option("--max-variants-per-scenario <n>", "Cap edge variants per scenario (default: 3)").option("--max-variants-per-run <n>", "Cap edge variants per run (default: 40)").option("--realism <profile>", "Discovery realism: robot, careful-user, casual-user, frustrated-user, power-user").option("--seed <n>", "Replay a specific random seed").option("--only <filter>", "Filter discovery scenarios by id substring or app type").option("--app-type <types>", "Filter discovery app types (comma-separated); only generates scenarios for these types if the classifier matches them").option("--force-app-type <type>", "Force a single app type, bypassing the classifier entirely (use when classification returns blank)").option("--no-llm", "Disable LLM-backed discovery polish").option("--non-interactive", "Non-interactive mode for discovery (skips prompts and countdown)").option("--regenerate", "Regenerate sniff-scenarios/ before running (prompts on hand-edits)").option("--regenerate-only", "Regenerate sniff-scenarios/ and exit without running").option("--force-regenerate", "Regenerate sniff-scenarios/ and overwrite hand-edits").option("--verbose", "Print classification breakdown (top 3 guesses + matched signals per dimension)").option("--dry-run", "Discover: generate scenarios + classify without running browser or writing reports").action(async (target, options) => {
22
39
  const rootDir = target ? (await import("path")).resolve(target) : process.cwd();
23
40
  if (options.discover || options.regenerate || options.regenerateOnly || options.forceRegenerate || options.dryRun) {
24
- const { loadConfig: loadConfig2 } = await import("../loader-Z2DUGG5Z.js");
41
+ const { loadConfig: loadConfig2 } = await import("../loader-AMM63AOJ.js");
25
42
  const config2 = await loadConfig2(rootDir);
26
43
  if (!options.regenerateOnly && !options.dryRun) {
27
44
  await ensurePlaywrightBrowsers(config2.browser?.projects);
28
45
  }
29
- const { discoverCommand } = await import("../discover-QKGMYPHK.js");
46
+ const { discoverCommand } = await import("../discover-HA63UA4K.js");
30
47
  const appTypes = typeof options.appType === "string" ? options.appType.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
31
48
  const result = await discoverCommand({
32
49
  rootDir,
@@ -53,17 +70,17 @@ if (process.argv.includes("--mcp")) {
53
70
  });
54
71
  process.exit(result.exitCode);
55
72
  }
56
- const { unifiedCommand } = await import("../unified-YSOTPG5B.js");
57
- const { loadConfig } = await import("../loader-Z2DUGG5Z.js");
73
+ const { unifiedCommand } = await import("../unified-NUR2X5JV.js");
74
+ const { loadConfig } = await import("../loader-AMM63AOJ.js");
58
75
  const config = await loadConfig(rootDir);
59
76
  let url = options.url ?? config.browser?.baseUrl;
60
77
  if (!url && options.browser !== false) {
61
- const { detectDevServerUrl } = await import("../dev-server-detector-XQ5AYPDT.js");
78
+ const { detectDevServerUrl } = await import("../dev-server-detector-FMFVKDJR.js");
62
79
  const detection = await detectDevServerUrl(rootDir);
63
80
  if (detection.url) {
64
81
  url = detection.url;
65
82
  if (!options.json) {
66
- const pc2 = (await import("picocolors")).default;
83
+ const pc2 = (await import("../picocolors-3W2AX5TJ.js")).default;
67
84
  console.log(`${pc2.green("[auto]")} Found dev server at ${pc2.bold(url)} (${detection.detail})
68
85
  `);
69
86
  }
@@ -71,10 +88,10 @@ if (process.argv.includes("--mcp")) {
71
88
  }
72
89
  const wantsBrowser = !!url && options.browser !== false;
73
90
  const isCi = options.ci || !!process.env.CI;
74
- const pc = (await import("picocolors")).default;
91
+ const pc = (await import("../picocolors-3W2AX5TJ.js")).default;
75
92
  if (wantsBrowser) {
76
93
  await ensurePlaywrightBrowsers(config.browser?.projects);
77
- const { crawlCommand } = await import("../crawl-command-RDWGHZC4.js");
94
+ const { crawlCommand } = await import("../crawl-command-Y45FIXNK.js");
78
95
  const storageState = options.storageState ? (await import("path")).resolve(options.storageState) : config.browser?.storageState;
79
96
  const code = await crawlCommand({
80
97
  rootDir,
@@ -93,7 +110,7 @@ if (process.argv.includes("--mcp")) {
93
110
  process.exit(code);
94
111
  }
95
112
  if (!options.json) {
96
- const { getDevCommand } = await import("../dev-server-detector-XQ5AYPDT.js");
113
+ const { getDevCommand } = await import("../dev-server-detector-FMFVKDJR.js");
97
114
  const devCmd = await getDevCommand(rootDir).catch(() => null);
98
115
  console.log(`${pc.yellow("No running app detected")}: no --url and no dev server.`);
99
116
  console.log(pc.dim("Running a source-only scan. For the full flow-walk that finds real bugs,"));
@@ -113,35 +130,35 @@ if (process.argv.includes("--mcp")) {
113
130
  });
114
131
  });
115
132
  program.command("init").description("Generate a sniff config file (auto-detects .ts vs .js based on project)").option("--force", "Overwrite existing config").option("--ts", "Force TypeScript config (sniff.config.ts)").option("--js", "Force JavaScript config (sniff.config.mjs if ESM, sniff.config.js if CJS)").action(async (options) => {
116
- const { initCommand } = await import("../init-IQKT4ANC.js");
133
+ const { initCommand } = await import("../init-POX5ZJ6V.js");
117
134
  await initCommand(options);
118
135
  });
119
136
  program.command("ci").description("Generate a GitHub Actions workflow").option("--output <path>", "Output path for workflow file", ".github/workflows/sniff.yml").option("--force", "Overwrite existing workflow file").option("--package-name <name>", "npm package name for npx command", "sniff-qa").action(async (options) => {
120
- const { ciCommand } = await import("../ci-ISCWZJD3.js");
137
+ const { ciCommand } = await import("../ci-F6FUXT3O.js");
121
138
  await ciCommand(options);
122
139
  });
123
- program.command("scan").description("Source-only scan (no browser): placeholder/TODO/console.log/dead links/etc.").argument("[target]", "Project directory (default: current directory)").option("--json", "Output results as JSON").option("--fail-on <severities>", "Exit non-zero on these severities (default: critical,high)", "critical,high").action(async (target, options) => {
140
+ program.command("scan").description("Source-only scan (no browser): placeholder/TODO/console.log/dead links/etc.").argument("[target]", "Project directory (default: current directory)").option("--json", "Output results as JSON").option("--fail-on <severities>", "Exit non-zero on these severities", "critical,high").action(async (target, options) => {
124
141
  const rootDir = target ? (await import("path")).resolve(target) : process.cwd();
125
- const { unifiedCommand } = await import("../unified-YSOTPG5B.js");
142
+ const { unifiedCommand } = await import("../unified-NUR2X5JV.js");
126
143
  await unifiedCommand({ rootDir, explore: false, json: options.json, failOn: options.failOn });
127
144
  });
128
145
  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) => {
129
- const { reportCommand } = await import("../report-7FQFH4HW.js");
146
+ const { reportCommand } = await import("../report-BOVSPRCR.js");
130
147
  await reportCommand(options);
131
148
  });
132
149
  program.command("update-baselines").description("Update visual regression baselines").option("--yes", "Skip confirmation prompt").action(async (options) => {
133
- const { updateBaselinesCommand } = await import("../update-baselines-JYKUUIZG.js");
150
+ const { updateBaselinesCommand } = await import("../update-baselines-TMERPIDV.js");
134
151
  await updateBaselinesCommand(options);
135
152
  });
136
153
  program.command("discover").description("Run autonomous E2E discovery (scenarios + edge cases)").argument("[target]", "Project directory (default: current directory)").option("--url <url>", "Target URL (default: auto-detect dev server)").option("--ci", "CI mode: headless, robot realism, no countdown, JUnit output").option("--headed", "Show the browser window (alias for --no-headless)").option("--no-headless", "Show the browser window").option("--format <formats>", "Report formats: html, json, junit (comma-separated)").option("--json", "Output results as JSON").option("--max-scenarios <n>", "Cap total scenarios (default: 50)").option("--max-variants-per-scenario <n>", "Cap edge variants per scenario (default: 3)").option("--max-variants-per-run <n>", "Cap edge variants per run (default: 40)").option("--realism <profile>", "Realism: robot, careful-user, casual-user, frustrated-user, power-user").option("--seed <n>", "Replay a specific random seed").option("--only <filter>", "Filter scenarios by id substring or app type").option("--app-type <types>", "Filter discovery app types (comma-separated); only generates scenarios for these types if the classifier matches them").option("--force-app-type <type>", "Force a single app type, bypassing the classifier entirely (use when classification returns blank)").option("--no-llm", "Disable LLM-backed polish").option("--non-interactive", "Skip prompts and the production-URL countdown").option("--regenerate", "Regenerate sniff-scenarios/ before running (prompts on hand-edits)").option("--regenerate-only", "Regenerate sniff-scenarios/ and exit without running").option("--force-regenerate", "Regenerate sniff-scenarios/ and overwrite hand-edits").option("--verbose", "Print classification breakdown (top 3 guesses + matched signals per dimension)").option("--dry-run", "Generate scenarios + classify without running browser or writing reports").action(async (target, options) => {
137
154
  if (!options.regenerateOnly && !options.dryRun) {
138
- const { loadConfig } = await import("../loader-Z2DUGG5Z.js");
155
+ const { loadConfig } = await import("../loader-AMM63AOJ.js");
139
156
  const rootDir2 = target ? (await import("path")).resolve(target) : process.cwd();
140
157
  const config = await loadConfig(rootDir2);
141
158
  await ensurePlaywrightBrowsers(config.browser?.projects);
142
159
  }
143
160
  const rootDir = target ? (await import("path")).resolve(target) : process.cwd();
144
- const { discoverCommand } = await import("../discover-QKGMYPHK.js");
161
+ const { discoverCommand } = await import("../discover-HA63UA4K.js");
145
162
  const appTypes = typeof options.appType === "string" ? options.appType.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
146
163
  const result = await discoverCommand({
147
164
  rootDir,
@@ -172,12 +189,40 @@ if (process.argv.includes("--mcp")) {
172
189
  process.exit(result.exitCode);
173
190
  });
174
191
  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) => {
175
- const { fixCommand } = await import("../fix-R33D34NP.js");
192
+ const { fixCommand } = await import("../fix-IXOEHAOS.js");
176
193
  const rootDir = target ? (await import("path")).resolve(target) : process.cwd();
177
194
  await fixCommand({ rootDir, dryRun: !!options.check, json: !!options.json });
178
195
  });
196
+ program.command("install").description("Download the browser engine (Playwright, axe-core, Lighthouse) and browsers once, so the first walk starts at once").argument("[browsers...]", "Browsers to download: chromium, firefox, webkit (default: chromium)").option("--with-deps", "Also install the system libraries the browsers need (Linux CI, needs root)").option("--deps-only", "Only install the system libraries (skip downloads already cached)").action(async (browsers, options) => {
197
+ const pc = (await import("../picocolors-3W2AX5TJ.js")).default;
198
+ const allowed = ["chromium", "firefox", "webkit"];
199
+ const bad = browsers.filter((b) => !allowed.includes(b));
200
+ if (bad.length > 0) {
201
+ console.error(pc.red(`Unknown browser: ${bad.join(", ")}. Use one of: ${allowed.join(", ")}.`));
202
+ process.exit(1);
203
+ }
204
+ const projects = browsers.length > 0 ? browsers : ["chromium"];
205
+ const { ensureEngineForCli, installPlaywrightBrowserProjects, installBrowserSystemDeps } = await import("../ensure-browsers-TNMHMLRS.js");
206
+ const started = Date.now();
207
+ await ensureEngineForCli();
208
+ if (options.depsOnly) {
209
+ await installBrowserSystemDeps(projects);
210
+ } else {
211
+ console.error(pc.dim(`Downloading ${projects.join(", ")} (skipped when already on disk)...`));
212
+ const result = await installPlaywrightBrowserProjects(projects, {
213
+ withDeps: !!options.withDeps,
214
+ stdio: "inherit-stderr"
215
+ });
216
+ if (result.status === "failed") {
217
+ console.error(pc.red(`Could not download ${projects.join(", ")}: ${result.error}`));
218
+ process.exit(1);
219
+ }
220
+ }
221
+ const secs = Math.round((Date.now() - started) / 1e3);
222
+ console.log(`${pc.green("OK")} sniff is ready to walk an app (${secs} s). Next: ${pc.bold("sniff --url http://localhost:3000")}`);
223
+ });
179
224
  program.command("doctor").description("Check your environment: Node.js, Playwright, config, dev server").action(async () => {
180
- const pc = (await import("picocolors")).default;
225
+ const pc = (await import("../picocolors-3W2AX5TJ.js")).default;
181
226
  const rootDir = process.cwd();
182
227
  console.log(`
183
228
  ${pc.bold("sniff doctor")}
@@ -186,15 +231,23 @@ ${pc.bold("sniff doctor")}
186
231
  const nodeMajor = parseInt(nodeVersion.slice(1), 10);
187
232
  const nodeOk = nodeMajor >= 22;
188
233
  console.log(` ${nodeOk ? pc.green("OK") : pc.red("!! ")} Node.js ${nodeVersion} ${nodeOk ? "" : "(need 22+)"}`);
189
- let playwrightOk = false;
190
- try {
191
- const { chromium } = await import("playwright");
192
- chromium.executablePath();
193
- playwrightOk = true;
194
- } catch {
234
+ const { engineStatus, engineDir, engineInstallCommand, ENGINE_SIZE_MB } = await import("../engine-AXB5O4ZH.js");
235
+ const engine = engineStatus();
236
+ if (engine === "resolved") {
237
+ console.log(` ${pc.green("OK")} Browser engine installed next to sniff`);
238
+ } else if (engine === "engine-dir") {
239
+ console.log(` ${pc.green("OK")} Browser engine downloaded (${engineDir()})`);
240
+ } else {
241
+ console.log(` ${pc.yellow("--")} Browser engine not downloaded yet (the first walk downloads it, about ${ENGINE_SIZE_MB} MB, or run: ${engineInstallCommand()})`);
242
+ }
243
+ const { checkPlaywrightBrowsers } = await import("../ensure-browsers-TNMHMLRS.js");
244
+ const browser = engine === "missing" ? null : await checkPlaywrightBrowsers(["chromium"]);
245
+ if (browser?.status === "installed") {
246
+ console.log(` ${pc.green("OK")} Chromium downloaded`);
247
+ } else {
248
+ console.log(` ${pc.yellow("--")} Chromium not downloaded yet (the first walk downloads it, about 165 MB, or run: ${engineInstallCommand(["chromium"])})`);
195
249
  }
196
- console.log(` ${playwrightOk ? pc.green("OK") : pc.yellow("--")} Playwright ${playwrightOk ? "installed" : "not installed (auto-installs on first browser scan)"}`);
197
- const { loadConfig } = await import("../loader-Z2DUGG5Z.js");
250
+ const { loadConfig } = await import("../loader-AMM63AOJ.js");
198
251
  let hasConfig = false;
199
252
  try {
200
253
  const config = await loadConfig(rootDir);
@@ -203,7 +256,7 @@ ${pc.bold("sniff doctor")}
203
256
  } catch {
204
257
  console.log(` ${pc.green("OK")} No config file (using defaults)`);
205
258
  }
206
- const { detectDevServerUrl, getDevCommand } = await import("../dev-server-detector-XQ5AYPDT.js");
259
+ const { detectDevServerUrl, getDevCommand } = await import("../dev-server-detector-FMFVKDJR.js");
207
260
  const detection = await detectDevServerUrl(rootDir);
208
261
  if (detection.url) {
209
262
  console.log(` ${pc.green("OK")} Dev server found at ${pc.bold(detection.url)} (${detection.detail})`);
@@ -242,4 +295,3 @@ ${pc.bold("sniff doctor")}
242
295
  });
243
296
  await program.parseAsync();
244
297
  }
245
- //# sourceMappingURL=index.js.map