@exodus/xqa 7.1.0 → 8.1.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 +24 -6
- package/dist/xqa.cjs +8922 -5465
- package/package.json +4 -5
package/README.md
CHANGED
|
@@ -242,10 +242,6 @@ agents:
|
|
|
242
242
|
analyser:
|
|
243
243
|
enabled: true
|
|
244
244
|
|
|
245
|
-
inspector:
|
|
246
|
-
enabled: true
|
|
247
|
-
designsDirectory: .xqa/designs
|
|
248
|
-
|
|
249
245
|
consolidator:
|
|
250
246
|
enabled: true
|
|
251
247
|
|
|
@@ -268,8 +264,6 @@ Field reference:
|
|
|
268
264
|
| `agents.explorer.capabilities.viewUiServer` | `true` | Registers the `view_ui` MCP tool for reading the UI tree. |
|
|
269
265
|
| `agents.explorer.capabilities.findingScreenshots` | `true` | Writes per-finding PNGs. |
|
|
270
266
|
| `agents.analyser.enabled` | `true` | Runs the Gemini video analyser. Needs `GOOGLE_GENERATIVE_AI_API_KEY`. |
|
|
271
|
-
| `agents.inspector.enabled` | `true` | Runs the visual diff inspector. |
|
|
272
|
-
| `agents.inspector.designsDirectory` | `.xqa/designs` | Reference artboards for visual diffing. |
|
|
273
267
|
| `agents.consolidator.enabled` | `true` | Merges and deduplicates findings from every agent. |
|
|
274
268
|
| `agents.triager.enabled` | `false` | Runs the PR suite matcher. Needs `GITHUB_TOKEN`. |
|
|
275
269
|
|
|
@@ -279,6 +273,30 @@ Each agent has a `capabilities` block of opt-in feature flags. Enabling a capabi
|
|
|
279
273
|
|
|
280
274
|
The explorer's `videoRecording` capability used to auto-turn-on whenever `GOOGLE_GENERATIVE_AI_API_KEY` was set. It's now independent: you can record video without running the analyser, and vice versa.
|
|
281
275
|
|
|
276
|
+
### Visual analysis
|
|
277
|
+
|
|
278
|
+
Explorer can perform visual review in addition to structural exploration. Enable via `agents.explorer.visual.enabled: true` in `.xqa/config.yaml`. When designs are available, point `designsDir` at a directory of `*.png` artboards.
|
|
279
|
+
|
|
280
|
+
| `visual.enabled` | `designsDir` | Behavior |
|
|
281
|
+
| ---------------- | -------------- | ----------------------------------------------------------------------- |
|
|
282
|
+
| `false` | any | Structural only (default; identical to today's explorer). |
|
|
283
|
+
| `true` | set, non-empty | Full visual review with artboard comparison and `read_artboard` budget. |
|
|
284
|
+
| `true` | unset or empty | Visual review without artboard reference (design-system-blind). |
|
|
285
|
+
|
|
286
|
+
```yaml
|
|
287
|
+
explorer:
|
|
288
|
+
visual:
|
|
289
|
+
enabled: true
|
|
290
|
+
designsDir: .xqa/designs
|
|
291
|
+
matchTolerance: balanced # strict | balanced | loose
|
|
292
|
+
candidateCount: 3
|
|
293
|
+
readArtboardImageTokenBudget: 80000
|
|
294
|
+
# Per-run in-memory cache that skips visual_pass on screens already
|
|
295
|
+
# analysed during this run. Every analysed screen's fingerprint is
|
|
296
|
+
# kept for the lifetime of the run.
|
|
297
|
+
cacheTolerance: strict # strict | balanced | loose — how lenient to be when calling two screens "the same"
|
|
298
|
+
```
|
|
299
|
+
|
|
282
300
|
### Environment variables
|
|
283
301
|
|
|
284
302
|
Secrets stay in `.env.local` (loaded by dotenv) or your shell. Lock the file down:
|