@decocms/parity 0.33.25 → 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.
- package/AGENTS.md +7 -2
- package/README.md +3 -4
- package/dist/cli.js +1411 -1093
- 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 ... --
|
|
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
|
|
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
|
|
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 #
|
|
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
|
-
|
|
89
|
-
└── console/ # console messages captured per page
|
|
88
|
+
└── traces/ # Playwright traces — drag into trace.playwright.dev
|
|
90
89
|
```
|
|
91
90
|
|
|
92
91
|
## Presets
|