sniff-qa 0.5.2 → 0.6.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 (33) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/CHANGELOG.md +60 -0
  3. package/README.md +219 -347
  4. package/SECURITY.md +3 -3
  5. package/dist/chunk-LJYT4MD5.js +1246 -0
  6. package/dist/chunk-LJYT4MD5.js.map +1 -0
  7. package/dist/cli/index.js +41 -12
  8. package/dist/cli/index.js.map +1 -1
  9. package/dist/crawl-666NLYDC.js +11 -0
  10. package/dist/crawl-666NLYDC.js.map +1 -0
  11. package/dist/crawl-command-3OB4IUBU.js +54 -0
  12. package/dist/crawl-command-3OB4IUBU.js.map +1 -0
  13. package/dist/{discover-ENPRVN5A.js → discover-Q363YJ5X.js} +2 -2
  14. package/dist/{domain-UQ34YE4B.js → domain-NNL2PPRK.js} +1 -1
  15. package/dist/index.d.ts +94 -1
  16. package/dist/index.js +9 -1
  17. package/dist/index.js.map +1 -1
  18. package/dist/mcp/server.js +76 -6
  19. package/dist/mcp/server.js.map +1 -1
  20. package/dist/{model-X5J2JR5U.js → model-2DTSAX7T.js} +1 -1
  21. package/dist/{quality-run-6SXCN5CD.js → quality-run-LLBZZI7X.js} +2 -2
  22. package/dist/{repo-analyzer-4OURSITY.js → repo-analyzer-WK5WP7NT.js} +1 -1
  23. package/dist/{report-OAHSB56I.js → report-IKRVVIW4.js} +2 -2
  24. package/dist/{unified-SKXQQX3Y.js → unified-67Z6YA64.js} +4 -4
  25. package/package.json +2 -2
  26. package/skills/sniff/SKILL.md +20 -25
  27. /package/dist/{discover-ENPRVN5A.js.map → discover-Q363YJ5X.js.map} +0 -0
  28. /package/dist/{domain-UQ34YE4B.js.map → domain-NNL2PPRK.js.map} +0 -0
  29. /package/dist/{model-X5J2JR5U.js.map → model-2DTSAX7T.js.map} +0 -0
  30. /package/dist/{quality-run-6SXCN5CD.js.map → quality-run-LLBZZI7X.js.map} +0 -0
  31. /package/dist/{repo-analyzer-4OURSITY.js.map → repo-analyzer-WK5WP7NT.js.map} +0 -0
  32. /package/dist/{report-OAHSB56I.js.map → report-IKRVVIW4.js.map} +0 -0
  33. /package/dist/{unified-SKXQQX3Y.js.map → unified-67Z6YA64.js.map} +0 -0
@@ -1,47 +1,42 @@
1
1
  ---
2
2
  name: sniff
3
- description: Scan the current project for bugs. Runs source code analysis (debug statements, dead links, API endpoints, broken imports, placeholder text, hardcoded URLs). If a dev server is running, also checks accessibility, visual regression, and performance. No API key needed.
3
+ description: Use when the user types /sniff, or asks to "scan this project for bugs", "find bugs in my app", "QA my site", or "walk my app and tell me what's broken". For a running web app, finds real, reproducible issues — broken pages/links, console & network errors, broken forms, empty/placeholder data, state-loss, bad loading/error states, responsive and accessibility problems — each with reproduction proof, severity, confidence, and a fix. No API key needed.
4
4
  ---
5
5
 
6
- # /sniff - Scan this project
7
-
8
- Run a full quality scan on the current project.
6
+ # /sniff — find real bugs in this project
9
7
 
10
8
  ## What to do
11
9
 
12
- 1. Use the unified `sniff` MCP tool with:
13
- - `mode`: `"run"`
10
+ 1. Call the unified `sniff` MCP tool with:
11
+ - `mode`: `"walk"` — the autonomous flow-walk that drives a real browser and finds runtime bugs (this is the one that matters; `"scan"` is source-only)
14
12
  - `rootDir`: the current project's absolute path
15
- - Do NOT pass `baseUrl` -- sniff auto-detects running dev servers
16
- - `headless`: true
17
-
18
- 2. If the unified `sniff` tool is not available, use legacy `sniff_run`; if that is not available, use `sniff_scan` with just `rootDir`
19
-
20
- 3. Present the findings to the user grouped by severity:
21
- - CRITICAL and HIGH first
22
- - Show file path, line number, and the issue
23
- - Suggest fixes for the top issues
13
+ - omit `baseUrl` to auto-detect the running dev server, or pass it if the user gives a URL
14
+ 2. If the response is `{ needsSetup: "playwright-browsers" }`, call the `sniff_install` tool, then retry the walk.
15
+ 3. If no app is running, sniff returns a note + a source-only scan. Tell the user to start their dev server (or pass a URL) for the full flow-walk that finds the real runtime bugs.
16
+ 4. Present findings grouped by severity (CRITICAL and HIGH first). For each, show the **route**, the **reproduction steps**, the **confidence** (confirmed / likely / uncertain), and the **suggested fix**. Mention any finding marked `needsOutOfBandVerification` (e.g. "submitted but no success shown — confirm the email/job actually ran"). Offer `/sniff-fix` for the safe, auto-fixable ones.
24
17
 
25
18
  ## Example
26
19
 
27
20
  ```
28
21
  User: /sniff
29
- You: I'll scan your project for issues.
22
+ You: Walking your running app for real bugs…
30
23
 
31
- [calls sniff with mode=run rootDir=/Users/user/projects/my-app]
24
+ [calls sniff with mode="walk", rootDir=/Users/user/projects/my-app]
32
25
 
33
- Found 12 issues:
26
+ Found 9 real issues (0 false positives) across 12 pages:
34
27
 
35
28
  **Critical (1)**
36
- - `src/routes.ts:14` - Hardcoded Stripe key in route handler
29
+ - /checkout — Page returns HTTP 500 (crash screen shown to the user)
37
30
 
38
31
  **High (3)**
39
- - `src/handler.ts:42` - debugger statement
40
- - `README.md:28` - Broken link to ./missing-guide.md
41
- - `src/Page.tsx:15` - Lorem ipsum placeholder text
32
+ - / — Broken link → /pricing-old (HTTP 404)
33
+ - /dashboard — Uncaught exception: cannot read 'map' of undefined
34
+ - /signup — Submit button does nothing (no request, no message, no change)
42
35
 
43
- **Medium (8)**
44
- - ...
36
+ **Medium (5)**
37
+ - /orders — Empty table with no empty-state ("Your Orders")
38
+ - /profile — Placeholder data shipped (test@test.com)
39
+ - …each with reproduction steps + a screenshot + a fix.
45
40
 
46
- Want me to fix any of these?
41
+ Want me to fix the safe ones with /sniff-fix?
47
42
  ```