sniff-qa 0.5.2 → 0.7.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/.claude-plugin/plugin.json +2 -2
- package/CHANGELOG.md +87 -1
- package/README.md +274 -342
- package/SECURITY.md +3 -3
- package/dist/chunk-LJYT4MD5.js +1246 -0
- package/dist/chunk-LJYT4MD5.js.map +1 -0
- package/dist/cli/index.js +41 -12
- package/dist/cli/index.js.map +1 -1
- package/dist/crawl-666NLYDC.js +11 -0
- package/dist/crawl-666NLYDC.js.map +1 -0
- package/dist/crawl-command-3OB4IUBU.js +54 -0
- package/dist/crawl-command-3OB4IUBU.js.map +1 -0
- package/dist/{discover-ENPRVN5A.js → discover-Q363YJ5X.js} +2 -2
- package/dist/{domain-UQ34YE4B.js → domain-NNL2PPRK.js} +1 -1
- package/dist/index.d.ts +94 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/server.js +76 -6
- package/dist/mcp/server.js.map +1 -1
- package/dist/{model-X5J2JR5U.js → model-2DTSAX7T.js} +1 -1
- package/dist/{quality-run-6SXCN5CD.js → quality-run-LLBZZI7X.js} +2 -2
- package/dist/{repo-analyzer-4OURSITY.js → repo-analyzer-WK5WP7NT.js} +1 -1
- package/dist/{report-OAHSB56I.js → report-IKRVVIW4.js} +2 -2
- package/dist/{unified-SKXQQX3Y.js → unified-67Z6YA64.js} +4 -4
- package/package.json +2 -2
- package/skills/sniff/SKILL.md +20 -25
- /package/dist/{discover-ENPRVN5A.js.map → discover-Q363YJ5X.js.map} +0 -0
- /package/dist/{domain-UQ34YE4B.js.map → domain-NNL2PPRK.js.map} +0 -0
- /package/dist/{model-X5J2JR5U.js.map → model-2DTSAX7T.js.map} +0 -0
- /package/dist/{quality-run-6SXCN5CD.js.map → quality-run-LLBZZI7X.js.map} +0 -0
- /package/dist/{repo-analyzer-4OURSITY.js.map → repo-analyzer-WK5WP7NT.js.map} +0 -0
- /package/dist/{report-OAHSB56I.js.map → report-IKRVVIW4.js.map} +0 -0
- /package/dist/{unified-SKXQQX3Y.js.map → unified-67Z6YA64.js.map} +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sniff",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.7.0",
|
|
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 Boudj",
|
|
7
7
|
"url": "https://github.com/Aboudjem/sniff"
|
package/CHANGELOG.md
CHANGED
|
@@ -5,7 +5,93 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
-
## [
|
|
8
|
+
## [0.7.0] - 2026-05-29
|
|
9
|
+
|
|
10
|
+
Portability and discoverability layer: a multi-CLI installer, auto-discovery manifests, a GitHub Pages demo, and localized READMEs, on top of the earlier documentation polish. No change to the scanner engine or its findings.
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- Multi-CLI installer: `install.sh` and `install.ps1` symlink the `/sniff`, `/sniff-fix`, and `/sniff-report` skills into a target CLI's skills directory, with `--update` and `--uninstall` and a one-line curl install. The MCP server stays the universal fallback.
|
|
15
|
+
- Auto-discovery manifests: `.cursor-plugin/plugin.json` and `.copilot-plugin/plugin.json`, mirroring `.claude-plugin/plugin.json`.
|
|
16
|
+
- GitHub Pages demo: `site/index.html` plus `.github/workflows/deploy-pages.yml`, reusing the existing demo assets and a sample report.
|
|
17
|
+
- README: a language-switcher row, a multi-platform install matrix with a one-line curl, an npm downloads badge, and a Star History chart.
|
|
18
|
+
- Localized READMEs under `READMEs/` for zh-CN, ja, es, and fr (machine-assisted; English stays the source of truth).
|
|
19
|
+
- Demo video: `.github/assets/demo.gif` (hero) plus an `.mp4` and an embed guide.
|
|
20
|
+
|
|
21
|
+
### Changed
|
|
22
|
+
|
|
23
|
+
- Rebuilt the features and hero SVGs around the flow-walk model, and removed emoji from them.
|
|
24
|
+
- Named the slash commands and MCP tools in the README.
|
|
25
|
+
|
|
26
|
+
### Removed
|
|
27
|
+
|
|
28
|
+
- Stale pre-0.6.0 SVG assets and the internal rebuild docs.
|
|
29
|
+
|
|
30
|
+
### Fixed
|
|
31
|
+
|
|
32
|
+
- `.github/FUNDING.yml`: corrected the GitHub Sponsors handle to `Aboudjem` (the previous value did not resolve).
|
|
33
|
+
- Animated SVGs now respect `prefers-reduced-motion`.
|
|
34
|
+
- Removed sentence-break em-dashes from the docs.
|
|
35
|
+
|
|
36
|
+
## [0.6.1] - 2026-05-28
|
|
37
|
+
|
|
38
|
+
Alignment release: no behaviour changes. Fixes the release pipeline so future tags can publish to npm,
|
|
39
|
+
updates stale copy across assets and docs to reflect the v0.6.0 flow-walk model, and adds 10x
|
|
40
|
+
marketplace cross-links.
|
|
41
|
+
|
|
42
|
+
### Fixed
|
|
43
|
+
|
|
44
|
+
- `release.yml`: added `npx playwright install --with-deps chromium` before the Test step so the
|
|
45
|
+
real-browser fixture gate no longer blocks the publish job (root cause of npm being stuck at 0.5.2).
|
|
46
|
+
- Logo SVGs (`logo-light.svg`, `logo-dark.svg`): replaced stale "eight checks" tagline with
|
|
47
|
+
"walks your app · finds real bugs · zero config · no api key".
|
|
48
|
+
- `social-preview.svg`: updated from `v0.4.0` / "374 tests pass" / old multi-scanner copy to
|
|
49
|
+
`v0.6.1` / "441 tests pass" / flow-walk description.
|
|
50
|
+
- `description.txt`: rewrote recommended GitHub About from old multi-scanner model to flow-walk model.
|
|
51
|
+
- Pipeline SVGs: updated title from "8 Checks in One Command" to "Autonomous Flow-Walk QA Pipeline".
|
|
52
|
+
- Report SVGs + HTML preview + `src/report/template.html`: updated version labels from `v0.2.0`/`v0.2.1`
|
|
53
|
+
to `v0.6.1`; updated `[source]` labels to `[walk]`.
|
|
54
|
+
- Architecture SVGs: updated MCP tool names from `sniff_scan / sniff_run / sniff_report` to unified
|
|
55
|
+
`sniff tool (mode: walk | scan | report)`; renamed "Source Scanner" block to "Flow-Walk Engine".
|
|
56
|
+
- `modes.svg`: updated "source scan" label to "sniff scan".
|
|
57
|
+
- `bug_report.yml`: updated version placeholder from `0.5.2` to `0.6.1`.
|
|
58
|
+
- `feature_request.yml`: replaced old scanner taxonomy with current flow-walk / sniff-scan options.
|
|
59
|
+
- `CLAUDE.md`: updated project description from old source-scan model to flow-walk model.
|
|
60
|
+
- `docs/VIDEO-PLAN.md`: replaced "Eight checks" script lines with flow-walk wording.
|
|
61
|
+
- `.claude/skills/sniff-scan.md`, `sniff-fix.md`, `sniff-report.md`: aligned to unified `sniff` tool
|
|
62
|
+
(mode: walk/scan/report); legacy tool names kept as fallback references only.
|
|
63
|
+
- `llms.txt`: added 10x marketplace install path and "part of the 10x marketplace" line.
|
|
64
|
+
- `AGENTS.md`: added 10x marketplace section.
|
|
65
|
+
|
|
66
|
+
## [0.6.0] - 2026-05-29
|
|
67
|
+
|
|
68
|
+
This release rebuilds Sniff around an autonomous **flow-walk** engine that drives your running app in a real headless browser and reports what is actually broken, with reproduction proof on every finding. The flow-walk is now the default; the old source-code regex scan moves to an explicit `sniff scan` subcommand.
|
|
69
|
+
|
|
70
|
+
### Added
|
|
71
|
+
|
|
72
|
+
- **Flow-walk engine (now the default)**: `sniff` auto-detects your running dev server and walks its real user flows in a headless browser, falling back to a source scan with clear guidance when no app is running. Point it at any URL with `sniff --url <url>`.
|
|
73
|
+
- **12 issue classes detected during the walk**: broken pages/routes (4xx/5xx, blank renders, crash screens), broken links (internal + external), console errors / uncaught exceptions / failed network requests, empty data + placeholder/fake data, broken forms (dead submit buttons, validation that never fires), state-loss on back navigation, flow regressions / dead-ends, bad loading states + missing error states, broken async outcomes (flagged "needs out-of-band verification"), responsive issues (overflow, tiny tap targets), accessibility (via axe-core), and unclear/buried primary actions.
|
|
74
|
+
- **Reproduction proof on every finding**: exact route, ordered steps, a screenshot, and the console/network excerpt, plus a severity, a confidence level (confirmed / likely / uncertain), and a suggested fix. A finding without reproduction proof is not a finding.
|
|
75
|
+
- **`walk` MCP mode** on the unified `sniff` tool (recommended), alongside `scan` (source only) and `report` (last results). Auto-detects the dev server when `baseUrl` is omitted, so "scan this project for bugs" / "walk my app" works out of the box.
|
|
76
|
+
- **`sniff scan` subcommand**: source-only scan with no browser (placeholder/TODO/console.log/dead links and more).
|
|
77
|
+
- **Self-contained HTML report** via `--report`, written to `sniff-reports/sniff-report.html`.
|
|
78
|
+
- **`--all` flag** to surface low-confidence (uncertain) findings, which are hidden by default.
|
|
79
|
+
- **Planted-bug fixture + regression gate**: 21 planted bugs across all 12 issue classes plus a clean control page, with a scorer at `sniff-tests/`, locked in as a regression test.
|
|
80
|
+
|
|
81
|
+
### Changed
|
|
82
|
+
|
|
83
|
+
- **Default behavior**: `sniff` now performs the autonomous flow-walk instead of a source-code regex scan. The source scan is still available as `sniff scan`.
|
|
84
|
+
- **Responsive pass** runs a 375px mobile viewport by default; skip it with `--no-mobile`.
|
|
85
|
+
- **Noise filtering**: a first-party noise filter drops favicons, analytics, HMR, expected-auth, and engine-abort noise so the report stays high-signal; broken pages are reported once rather than re-flagged.
|
|
86
|
+
- **Confidence model**: uncertain findings are suppressed by default and axe-core (zero-false-positive by design) backs the accessibility findings.
|
|
87
|
+
|
|
88
|
+
### Fixed
|
|
89
|
+
|
|
90
|
+
- **`discover --url` crash**: the flow-walker entry point no longer crashes when given a URL; it is now the supported default path.
|
|
91
|
+
|
|
92
|
+
### Proof
|
|
93
|
+
|
|
94
|
+
- Measured on the planted-bug fixture (21 bugs across all 12 classes + a clean control page): the previous engine found 9/21 (43%) at ~13% precision with 125 false positives and its flagship command crashed. The new engine finds **21/21 (100%) at 100% precision with 0 false positives** and reports 0 findings on the clean page. The full suite is 441 tests.
|
|
9
95
|
|
|
10
96
|
## [0.5.2] - 2026-05-06
|
|
11
97
|
|