@decocms/parity 0.33.24 → 0.33.26

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 (4) hide show
  1. package/AGENTS.md +7 -2
  2. package/README.md +3 -4
  3. package/dist/cli.js +1871 -1282
  4. package/package.json +1 -1
package/AGENTS.md CHANGED
@@ -26,12 +26,12 @@ Do **not** run parity for:
26
26
  | "compare these two URLs in CI" | `parity journey --prod ... --cand ... --junit ... --github` |
27
27
  | "find sections missing in the migration" | `parity run --visual-pages 5` then read `report.json` `.visualDiff` |
28
28
  | "did web vitals regress?" | `parity vitals --prod ... --cand ... --limit 20` |
29
- | "is the new site missing cache?" | `parity cache --cand ... --pages 30` |
29
+ | "is the new site missing cache?" | `parity cache --cand ... --limit 30` |
30
30
  | "I want an LLM prompt with all the issues" | `parity prompt <runId>` (writes Markdown to stdout) |
31
31
  | "explain this specific issue" | `parity explain <runId> <issueId>` (needs `ANTHROPIC_API_KEY`) |
32
32
  | "does THIS single site actually work?" | `parity e2e --url ... --flows ...` (no comparison — pre-launch / partner audit) |
33
33
  | "exercise search / cart / login on a site" | `parity e2e --url ... --flows=search,cart-interactions,login` |
34
- | "migrate a live storefront to a new stack" | `parity migrate --url ... --target faststore` (phased capture → agent-ready bundle; see `docs/migrate.md`) |
34
+ | "migrate a live storefront to a new stack" | `parity capture --url ... --target faststore` (phased capture → agent-ready bundle; see `docs/migrate.md`) |
35
35
 
36
36
  ### `parity run` vs `parity e2e` — decision tree
37
37
 
@@ -67,6 +67,11 @@ Do **not** fake single-site with `parity run --prod X --cand X` — it runs ever
67
67
  }
68
68
  ```
69
69
 
70
+ `flowCaptures[].pages[].html` (the raw page HTML each check consumes while the run
71
+ is live) is **not** persisted — a full run's captures were 88 MB of it, 95% of the
72
+ file, and nothing reads it back afterwards (issue #411). Need the raw HTML for a
73
+ specific URL? Capture it standalone with `parity html --url <url>`.
74
+
70
75
  To programmatically decide if a migration is ready:
71
76
 
72
77
  ```ts
package/README.md CHANGED
@@ -60,7 +60,7 @@ For agents driving `parity` in a loop, the stable surface is:
60
60
  | Drive a CI/CD pipeline | `parity pr --prod X --preview Y --github` | Markdown comment + `$GITHUB_STEP_SUMMARY` |
61
61
  | Drill into one issue | `parity explain <runId> <issueId>` | LLM deep-dive (needs key) |
62
62
  | Build a paste-ready prompt | `parity prompt <runId>` | Markdown ready for Claude/ChatGPT |
63
- | Generate visual-fix bundle | `parity fix --prod X --cand Y --selector S` | Markdown + screenshots + computed-styles diff |
63
+ | Generate visual-fix bundle | `parity section --all --prod X --cand Y --selector S` | Markdown + screenshots + computed-styles diff |
64
64
 
65
65
  See [`docs/cli.md`](./docs/cli.md) for every command, [`docs/checks.md`](./docs/checks.md) for every check.
66
66
  See [`docs/reports.md`](./docs/reports.md) for the HTML outputs and the two report template kits.
@@ -81,12 +81,11 @@ Without any provider, the CLI still runs and outputs raw check results — only
81
81
 
82
82
  ```
83
83
  ./parity-output/runs/<runId>/
84
- ├── report.html # standalone, open in any browser
84
+ ├── report.html # links to screenshots/ by relative path — keep the two together
85
85
  ├── report.json # structured output for agents / CI / tooling
86
86
  ├── screenshots/ # per-page, per-viewport, per-side; includes pixelmatch heatmaps
87
87
  ├── har/ # Playwright HARs (one per viewport/side)
88
- ├── traces/ # Playwright traces — drag into trace.playwright.dev
89
- └── console/ # console messages captured per page
88
+ └── traces/ # Playwright traces — drag into trace.playwright.dev
90
89
  ```
91
90
 
92
91
  ## Presets