sniff-qa 0.9.0 → 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 (172) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +39 -0
  3. package/NOTICE +7 -4
  4. package/README.md +35 -7
  5. package/THIRD-PARTY-NOTICES.md +1800 -0
  6. package/dist/{accessibility-JXRMWF5Y.js → accessibility-42JOUOGH.js} +8 -2
  7. package/dist/{anthropic-api-7PHYF6PN.js → anthropic-api-VSG2X6FS.js} +7 -5
  8. package/dist/assert-budget-WG4BRCLX.js +10 -0
  9. package/dist/{caps-G3ZGJI7B.js → caps-YZPFNPIN.js} +3 -2
  10. package/dist/{chunk-VEI2O6AK.js → chunk-33JL2AB5.js} +14 -6
  11. package/dist/{chunk-64FUDSRY.js → chunk-3E4W4H6S.js} +8 -5
  12. package/dist/{chunk-T72SLMTY.js → chunk-3NR2K5B3.js} +2 -1
  13. package/dist/chunk-3ROWRVZE.js +422 -0
  14. package/dist/{chunk-MYWWSM3V.js → chunk-3YFE3H23.js} +2 -1
  15. package/dist/{chunk-MMISGY2Q.js → chunk-4F6ZXOPE.js} +2 -1
  16. package/dist/chunk-A4TTASVS.js +27862 -0
  17. package/dist/{chunk-IXDUD2UG.js → chunk-AA744N7E.js} +2 -1
  18. package/dist/chunk-DZMX3VT2.js +267 -0
  19. package/dist/{chunk-NG2IGCAK.js → chunk-FR5QCJLH.js} +2 -1
  20. package/dist/{chunk-GV27IOMC.js → chunk-GC47B6MM.js} +2 -1
  21. package/dist/chunk-HP4TY3UY.js +80 -0
  22. package/dist/chunk-LZAPYYNR.js +4595 -0
  23. package/dist/{chunk-ZM6MGWO4.js → chunk-NBJLMLDA.js} +2 -1
  24. package/dist/chunk-RAGYZ54R.js +15480 -0
  25. package/dist/{chunk-GX36BPK7.js → chunk-RSGFFRXQ.js} +2 -2
  26. package/dist/chunk-SOBWDC35.js +38 -0
  27. package/dist/{chunk-7BLJCICM.js → chunk-US4HFUCH.js} +3 -2
  28. package/dist/chunk-YM22FEIA.js +5807 -0
  29. package/dist/{ci-ISCWZJD3.js → ci-F6FUXT3O.js} +5 -3
  30. package/dist/{classifier-MWQMQ727.js → classifier-5FQ2FBTO.js} +3 -1
  31. package/dist/{claude-code-GJPWO6DN.js → claude-code-J43C22IR.js} +7 -5
  32. package/dist/{claude-exploration-provider-XOVJPJ23.js → claude-exploration-provider-EWQNNE7D.js} +3 -2
  33. package/dist/cli/index.js +69 -31
  34. package/dist/compiler-sfc.cjs-JX56AWNS.js +48568 -0
  35. package/dist/crawl-KN7SW753.js +26 -0
  36. package/dist/{crawl-command-JHZN4GK7.js → crawl-command-Y45FIXNK.js} +7 -6
  37. package/dist/{cross-reference-MHNPSLEN.js → cross-reference-XOOBW6UZ.js} +3 -1
  38. package/dist/{dev-server-detector-XQ5AYPDT.js → dev-server-detector-FMFVKDJR.js} +3 -1
  39. package/dist/{discover-QKGMYPHK.js → discover-HA63UA4K.js} +20 -18
  40. package/dist/dist-3CYER35S.js +8 -0
  41. package/dist/{domain-UQ34YE4B.js → domain-FU3WIW64.js} +45 -30
  42. package/dist/{edge-cases-ZADKDZHL.js → edge-cases-B6IV3IKK.js} +3 -1
  43. package/dist/{element-extractor-OZTFBVKZ.js → element-extractor-QAG4MRUO.js} +18 -6
  44. package/dist/engine-AXB5O4ZH.js +39 -0
  45. package/dist/{ensure-browsers-5NAQQMEC.js → ensure-browsers-TNMHMLRS.js} +59 -12
  46. package/dist/errors-NWB25P4K.js +8 -0
  47. package/dist/esm-IMWPYLSN.js +3469 -0
  48. package/dist/{fix-R33D34NP.js → fix-IXOEHAOS.js} +12 -5
  49. package/dist/{flakiness-OLJAY7CS.js → flakiness-7SSSM4SW.js} +3 -2
  50. package/dist/flakiness-CBKV4U54.js +12 -0
  51. package/dist/{formatter-4VI3ZX5Y.js → formatter-N4CC7SCM.js} +29 -22
  52. package/dist/{framework-detector-ISSM2Q2I.js → framework-detector-4ZVHNT7N.js} +3 -1
  53. package/dist/generator-GGJYWYI2.js +8 -0
  54. package/dist/index.js +9 -6
  55. package/dist/{init-IQKT4ANC.js → init-POX5ZJ6V.js} +4 -2
  56. package/dist/json-4VOVHDQG.js +10 -0
  57. package/dist/{junit-GL44ATRR.js → junit-V24COOSR.js} +3 -1
  58. package/dist/{llm-VJAI6H6G.js → llm-TZ2WZGRZ.js} +3 -1
  59. package/dist/{loader-Z2DUGG5Z.js → loader-AMM63AOJ.js} +12 -3
  60. package/dist/mcp/server.js +13035 -72
  61. package/dist/{model-SP6HJN6J.js → model-BL2AID5Q.js} +6 -5
  62. package/dist/page-hooks-SECSGZR6.js +14 -0
  63. package/dist/{page-state-extractor-GYYLYRFR.js → page-state-extractor-AP4FQVLY.js} +3 -1
  64. package/dist/{performance-7HWKY5O2.js → performance-JVEYVBTV.js} +9 -3
  65. package/dist/{persistence-XLFJ5EY4.js → persistence-SHKJVSIS.js} +5 -4
  66. package/dist/{persistence-KTCRIGHU.js → persistence-SQ6QT3HP.js} +3 -1
  67. package/dist/picocolors-3W2AX5TJ.js +6 -0
  68. package/dist/pixelmatch-GATIVDQX.js +188 -0
  69. package/dist/png-HTC2G4ZG.js +2093 -0
  70. package/dist/{prompt-builder-JT3GQBYP.js → prompt-builder-EI2BFKLZ.js} +3 -1
  71. package/dist/{provider-MMQ6EIBV.js → provider-O3UOALQH.js} +14 -12
  72. package/dist/{quality-run-KJMBBAQT.js → quality-run-CTLX5YA5.js} +12 -10
  73. package/dist/{redaction-CHAIVPCF.js → redaction-QNBV5QZ3.js} +4 -3
  74. package/dist/{registry-5XCXUAYJ.js → registry-JBBTSD7I.js} +3 -1
  75. package/dist/{repo-analyzer-4OURSITY.js → repo-analyzer-4XITIIAF.js} +6 -4
  76. package/dist/{report-SDZWX25B.js → report-4UVJL7QV.js} +3 -1
  77. package/dist/{report-XK2MCX2N.js → report-BOVSPRCR.js} +8 -6
  78. package/dist/{response-parser-PUGNWF7S.js → response-parser-GHVJSYXQ.js} +3 -2
  79. package/dist/{route-discoverer-QBZCRQLJ.js → route-discoverer-ZXYJQIYE.js} +15 -8
  80. package/dist/{runner-RDVVIGBU.js → runner-DOLCFA3S.js} +10 -5
  81. package/dist/{runner-QHSYX7J2.js → runner-MCSDHFLN.js} +12 -7
  82. package/dist/{runner-AXZXNWYH.js → runner-MUBXHOIG.js} +10 -4
  83. package/dist/{scenarios-I7YYVTD2.js → scenarios-T2U6ZDRL.js} +3 -1
  84. package/dist/sdk-FQKA5HSQ.js +7184 -0
  85. package/dist/{source-5LS2B7TN.js → source-T5MHBY5G.js} +14 -7
  86. package/dist/{tiebreak-L5UFNKU2.js → tiebreak-SXBXPT7B.js} +3 -1
  87. package/dist/{unified-OEGLPOGE.js → unified-NUR2X5JV.js} +23 -21
  88. package/dist/{update-baselines-JYKUUIZG.js → update-baselines-TMERPIDV.js} +4 -2
  89. package/dist/version-FEHABGAH.js +10 -0
  90. package/dist/{visual-EUZG2STF.js → visual-XHFPFQFX.js} +5 -3
  91. package/dist/{workflow-template-6DADGPHA.js → workflow-template-7C5CCK67.js} +13 -7
  92. package/dist/{write-report-Y4UPVXUO.js → write-report-6Q4MXBYD.js} +5 -4
  93. package/package.json +18 -9
  94. package/dist/accessibility-JXRMWF5Y.js.map +0 -1
  95. package/dist/anthropic-api-7PHYF6PN.js.map +0 -1
  96. package/dist/assert-budget-NBF3JYM7.js +0 -9
  97. package/dist/assert-budget-NBF3JYM7.js.map +0 -1
  98. package/dist/caps-G3ZGJI7B.js.map +0 -1
  99. package/dist/chunk-64FUDSRY.js.map +0 -1
  100. package/dist/chunk-7BLJCICM.js.map +0 -1
  101. package/dist/chunk-GV27IOMC.js.map +0 -1
  102. package/dist/chunk-GX36BPK7.js.map +0 -1
  103. package/dist/chunk-IXDUD2UG.js.map +0 -1
  104. package/dist/chunk-MMISGY2Q.js.map +0 -1
  105. package/dist/chunk-MYWWSM3V.js.map +0 -1
  106. package/dist/chunk-NG2IGCAK.js.map +0 -1
  107. package/dist/chunk-T72SLMTY.js.map +0 -1
  108. package/dist/chunk-VEI2O6AK.js.map +0 -1
  109. package/dist/chunk-ZM6MGWO4.js.map +0 -1
  110. package/dist/ci-ISCWZJD3.js.map +0 -1
  111. package/dist/classifier-MWQMQ727.js.map +0 -1
  112. package/dist/claude-code-GJPWO6DN.js.map +0 -1
  113. package/dist/claude-exploration-provider-XOVJPJ23.js.map +0 -1
  114. package/dist/cli/index.js.map +0 -1
  115. package/dist/crawl-XPHT3KIZ.js +0 -23
  116. package/dist/crawl-XPHT3KIZ.js.map +0 -1
  117. package/dist/crawl-command-JHZN4GK7.js.map +0 -1
  118. package/dist/cross-reference-MHNPSLEN.js.map +0 -1
  119. package/dist/dev-server-detector-XQ5AYPDT.js.map +0 -1
  120. package/dist/discover-QKGMYPHK.js.map +0 -1
  121. package/dist/domain-UQ34YE4B.js.map +0 -1
  122. package/dist/edge-cases-ZADKDZHL.js.map +0 -1
  123. package/dist/element-extractor-OZTFBVKZ.js.map +0 -1
  124. package/dist/ensure-browsers-5NAQQMEC.js.map +0 -1
  125. package/dist/errors-RFEOR527.js +0 -7
  126. package/dist/errors-RFEOR527.js.map +0 -1
  127. package/dist/fix-R33D34NP.js.map +0 -1
  128. package/dist/flakiness-OLJAY7CS.js.map +0 -1
  129. package/dist/flakiness-OVC7KGN2.js +0 -11
  130. package/dist/flakiness-OVC7KGN2.js.map +0 -1
  131. package/dist/formatter-4VI3ZX5Y.js.map +0 -1
  132. package/dist/framework-detector-ISSM2Q2I.js.map +0 -1
  133. package/dist/generator-AFHVMWC3.js +0 -7
  134. package/dist/generator-AFHVMWC3.js.map +0 -1
  135. package/dist/index.js.map +0 -1
  136. package/dist/init-IQKT4ANC.js.map +0 -1
  137. package/dist/json-YDWEB33Q.js +0 -8
  138. package/dist/json-YDWEB33Q.js.map +0 -1
  139. package/dist/junit-GL44ATRR.js.map +0 -1
  140. package/dist/llm-VJAI6H6G.js.map +0 -1
  141. package/dist/loader-Z2DUGG5Z.js.map +0 -1
  142. package/dist/mcp/server.js.map +0 -1
  143. package/dist/model-SP6HJN6J.js.map +0 -1
  144. package/dist/page-hooks-6RALVZB5.js +0 -13
  145. package/dist/page-hooks-6RALVZB5.js.map +0 -1
  146. package/dist/page-state-extractor-GYYLYRFR.js.map +0 -1
  147. package/dist/performance-7HWKY5O2.js.map +0 -1
  148. package/dist/persistence-KTCRIGHU.js.map +0 -1
  149. package/dist/persistence-XLFJ5EY4.js.map +0 -1
  150. package/dist/prompt-builder-JT3GQBYP.js.map +0 -1
  151. package/dist/provider-MMQ6EIBV.js.map +0 -1
  152. package/dist/quality-run-KJMBBAQT.js.map +0 -1
  153. package/dist/redaction-CHAIVPCF.js.map +0 -1
  154. package/dist/registry-5XCXUAYJ.js.map +0 -1
  155. package/dist/repo-analyzer-4OURSITY.js.map +0 -1
  156. package/dist/report-SDZWX25B.js.map +0 -1
  157. package/dist/report-XK2MCX2N.js.map +0 -1
  158. package/dist/response-parser-PUGNWF7S.js.map +0 -1
  159. package/dist/route-discoverer-QBZCRQLJ.js.map +0 -1
  160. package/dist/runner-AXZXNWYH.js.map +0 -1
  161. package/dist/runner-QHSYX7J2.js.map +0 -1
  162. package/dist/runner-RDVVIGBU.js.map +0 -1
  163. package/dist/scenarios-I7YYVTD2.js.map +0 -1
  164. package/dist/source-5LS2B7TN.js.map +0 -1
  165. package/dist/tiebreak-L5UFNKU2.js.map +0 -1
  166. package/dist/unified-OEGLPOGE.js.map +0 -1
  167. package/dist/update-baselines-JYKUUIZG.js.map +0 -1
  168. package/dist/version-FLE7ZHDX.js +0 -7
  169. package/dist/version-FLE7ZHDX.js.map +0 -1
  170. package/dist/visual-EUZG2STF.js.map +0 -1
  171. package/dist/workflow-template-6DADGPHA.js.map +0 -1
  172. package/dist/write-report-Y4UPVXUO.js.map +0 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sniff",
3
- "version": "0.9.0",
3
+ "version": "0.9.1",
4
4
  "description": "Autonomous QA scanner via sniff-qa: walks your running app in a real browser and reports real bugs (broken pages/links, console/network errors, broken forms, state-loss, empty/placeholder data, bad loading/error states, responsive + a11y) with reproduction proof, severity, confidence, and a fix. No API key.",
5
5
  "author": {
6
6
  "name": "Adam Boudjemaa",
package/CHANGELOG.md CHANGED
@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.9.1] - 2026-11-17
11
+
12
+ The MCP server now connects on a new machine's first start.
13
+
14
+ ### Fixed
15
+
16
+ - **First start of the MCP server.** `npx -y sniff-qa --mcp` had to download about 250 MB of
17
+ dependencies before it could answer the handshake. On a cold machine that took 23 to 92 s, past
18
+ Claude Code's 30 s connect timeout, and a killed download could leave a broken npx cache. Two
19
+ changes fix it. The browser engine (Playwright, axe-core for Playwright, Lighthouse,
20
+ chrome-launcher) is no longer an npm dependency: sniff downloads it on first use. The other
21
+ runtime dependencies are bundled into `dist/`, so the package depends on `zod` alone. The first
22
+ start now downloads two small packages. `npm run cold-start` re-measures it.
23
+ - **Licenses of bundled code.** `THIRD-PARTY-NOTICES.md` ships in the package with the license
24
+ text of every bundled package.
25
+ - **No "packages it lists are not installed" note in `claude plugin list`.** Claude Code installs
26
+ a plugin's npm dependencies when it caches the plugin. The old dependency tree was too large for
27
+ that step; the new one installs in seconds.
28
+ - `--help` printed the `--fail-on` default twice.
29
+
30
+ ### Added
31
+
32
+ - **`sniff install [browsers...]`** downloads the browser engine (about 200 MB, once per sniff
33
+ version, into `~/.cache/sniff-qa/engine/<version>`) and Chromium, so the first walk starts at
34
+ once. `--with-deps` also installs the Linux system libraries; `--deps-only` installs only those.
35
+ `SNIFF_ENGINE_DIR` moves the engine folder.
36
+ - The first CLI walk still downloads everything it needs by itself, with progress on stderr.
37
+ - The `sniff_install` MCP tool now downloads the engine too. Browser tools still answer
38
+ `needsSetup: playwright-browsers` until it has run, so no tool call blocks on a silent download.
39
+ - `sniff doctor` says where the engine loads from, or that it is not downloaded yet.
40
+
41
+ ### Changed
42
+
43
+ - Install hints say `npx -y sniff-qa@<version> install <browser>` instead of
44
+ `npx playwright install <browser>`, which could fetch a Playwright that does not match sniff's.
45
+ - `sniff ci` writes a workflow that runs `sniff-qa install --with-deps chromium` and caches
46
+ `~/.cache/sniff-qa` next to the Playwright browsers.
47
+ - A project that installs `playwright` or `lighthouse` itself keeps using its own copy.
48
+
10
49
  ## [0.9.0] - 2026-11-17
11
50
 
12
51
  Every report now opens with the answer. The first walk on a new machine works.
package/NOTICE CHANGED
@@ -8,7 +8,10 @@ If you use Sniff in your project, a mention or attribution is appreciated:
8
8
  - "QA powered by Sniff (https://github.com/Aboudjem/sniff)"
9
9
 
10
10
  Third-party licenses:
11
- - Playwright (Apache-2.0) - https://playwright.dev
12
- - axe-core (MPL-2.0) - https://www.deque.com/axe/
13
- - Lighthouse (Apache-2.0) - https://developer.chrome.com/docs/lighthouse
14
- - pixelmatch (ISC) - https://github.com/mapbox/pixelmatch
11
+ - The packages bundled into dist/ are listed, with their license texts, in
12
+ THIRD-PARTY-NOTICES.md.
13
+ - pixelmatch (ISC) - https://github.com/mapbox/pixelmatch (bundled)
14
+ - The browser engine is downloaded on first use, with its own licenses, not bundled:
15
+ - Playwright (Apache-2.0) - https://playwright.dev
16
+ - axe-core (MPL-2.0) - https://www.deque.com/axe/
17
+ - Lighthouse (Apache-2.0) - https://developer.chrome.com/docs/lighthouse
package/README.md CHANGED
@@ -23,7 +23,8 @@ npx sniff-qa --url http://localhost:3000
23
23
  ## What you get
24
24
 
25
25
  A report that opens with the verdict, then the three things to fix first, then every finding.
26
- This is the top of a real run on this repo's planted-bug fixture (2026-11-17, sniff 0.9.0):
26
+ This is the report from a real run on this repo's planted-bug fixture (2026-11-17, sniff 0.9.0).
27
+ The progress lines that print before it are left out.
27
28
 
28
29
  ```text
29
30
  VERDICT FAIL: 26 findings (1 critical, 13 high, 11 medium, 1 low)
@@ -47,6 +48,13 @@ This is the top of a real run on this repo's planted-bug fixture (2026-11-17, sn
47
48
 
48
49
  Each finding carries a severity, a confidence label, the route, the steps, a fix and a screenshot.
49
50
 
51
+ To reproduce it from a clone, start the fixture, then walk it from a second terminal:
52
+
53
+ ```bash
54
+ node sniff-tests/planted-bugs/server.mjs 4517
55
+ npx sniff-qa --url http://localhost:4517
56
+ ```
57
+
50
58
  | Output | Flag | Use it for |
51
59
  | :-------------- | :---------- | :------------------------------------------ |
52
60
  | Terminal report | (default) | Reading the result now |
@@ -92,8 +100,19 @@ npx skills add Aboudjem/sniff
92
100
  claude mcp add sniff-qa -- npx -y sniff-qa --mcp
93
101
  ```
94
102
 
95
- The first walk downloads a Chromium build once (about 165 MB). Run `npx sniff-qa doctor` to check
96
- Node, the browser and your dev server.
103
+ The first walk downloads two things, once: the browser engine (Playwright, axe-core and
104
+ Lighthouse, about 200 MB) and Chromium (about 165 MB). Both took 159 s here on 2026-11-17.
105
+ To do it ahead of time, run:
106
+
107
+ ```bash
108
+ npx sniff-qa install
109
+ ```
110
+
111
+ It ends with the time it took. `npx sniff-qa doctor` checks Node, the browser and your dev server.
112
+
113
+ The MCP server starts before those downloads. On a cold machine (empty npm cache),
114
+ `npx -y sniff-qa@0.9.1 --mcp` answered its first handshake in 1.4 to 1.9 s (5 runs of the release build). Version 0.9.0 took 23 to 92 s,
115
+ past Claude Code's 30 s connect limit. `npm run cold-start` re-measures it in a clone of this repo.
97
116
 
98
117
  <details>
99
118
  <summary>Project install and CI</summary>
@@ -134,7 +153,7 @@ The MCP server exposes these tools:
134
153
  | `sniff_install` | Downloads the Playwright browser |
135
154
  | `sniff_report` | Reads the last saved results |
136
155
 
137
- `--caps scan,report` narrows the server to those two tools, with no browser at all.
156
+ `--caps scan,report` narrows the server to `sniff_scan`, `sniff_report` and the unified `sniff` tool, with no browser at all.
138
157
 
139
158
  ## Works with
140
159
 
@@ -153,7 +172,7 @@ Their snippets are in [docs/editors.md](docs/editors.md).
153
172
 
154
173
  ## Proof
155
174
 
156
- Two commands re-print every number on this page.
175
+ Three commands re-print the numbers on this page. The first prints the fixture score.
157
176
 
158
177
  ```bash
159
178
  npm run build && npm run proof
@@ -168,6 +187,8 @@ It starts the planted-bug fixture, walks it, and scores the report. Output on 20
168
187
  Hard FP on clean page (/clean): 0
169
188
  ```
170
189
 
190
+ The sample above shows 26 findings and this run counts 27. The proof run uses `--all`, which adds the 1 low-confidence finding.
191
+
171
192
  The fixture holds 21 planted bugs across all 12 classes, plus a clean control page.
172
193
  The scorer is [sniff-tests/score-fixture.mjs](sniff-tests/score-fixture.mjs).
173
194
  The bugs are listed in [sniff-tests/planted-bugs/MANIFEST.json](sniff-tests/planted-bugs/MANIFEST.json).
@@ -176,10 +197,16 @@ The bugs are listed in [sniff-tests/planted-bugs/MANIFEST.json](sniff-tests/plan
176
197
  npm test
177
198
  ```
178
199
 
179
- Prints `Test Files 50 passed (50)` and `Tests 534 passed (534)` on 2026-11-17.
200
+ Prints `Test Files 52 passed (52)` and `Tests 555 passed (555)` on 2026-11-17.
180
201
  The suite includes the fixture gate. It fails the build if recall drops below 85%.
181
202
  It also fails on any finding on the clean page.
182
203
 
204
+ ```bash
205
+ node sniff-tests/mcp-smoke.mjs
206
+ ```
207
+
208
+ Prints the 6 MCP tools and the 20 findings quoted in the table above.
209
+
183
210
  ## FAQ
184
211
 
185
212
  **Do I need an API key or an account?**
@@ -202,7 +229,8 @@ More answers are in [docs/faq.md](docs/faq.md).
202
229
  ## Limits
203
230
 
204
231
  - It needs a running app for the walk. Without one you only get the source scan.
205
- - The first walk needs internet to download Chromium once.
232
+ - The first walk needs internet to download the browser engine and Chromium once, about 365 MB.
233
+ - Until then, MCP browser tools answer `needsSetup` and the agent calls `sniff_install` first.
206
234
  - Dead-link checking follows external links, so a walk requests the third-party URLs your pages link to.
207
235
  - Redaction covers report text, not screenshot pixels. A screenshot of a logged-in page can show private data.
208
236
  - It finds what a user would see. It does not read your server logs or measure load.