@exodus/xqa 7.0.0 → 8.0.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 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,26 @@ 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
+ ```
295
+
282
296
  ### Environment variables
283
297
 
284
298
  Secrets stay in `.env.local` (loaded by dotenv) or your shell. Lock the file down: