@decocms/parity 0.17.9 → 0.19.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/AGENTS.md +1 -0
- package/CHANGELOG.md +22 -0
- package/dist/cli.js +2305 -268
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -31,6 +31,7 @@ Do **not** run parity for:
|
|
|
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
35
|
|
|
35
36
|
### `parity run` vs `parity e2e` — decision tree
|
|
36
37
|
|
package/CHANGELOG.md
CHANGED
|
@@ -7,8 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.19.0] — 2026-08-17
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
* **`parity migrate` HTML visual report + `--open`.** A self-contained `index.html` (theme color swatches + tokens, per-viewport screenshots, brand assets, component table, VTEX IO → FastStore block map) written alongside `index.md`; `--open` launches it in the browser (same `open` package `parity run`/`audit` use). (#207)
|
|
15
|
+
|
|
16
|
+
### Fixed
|
|
17
|
+
|
|
18
|
+
* **`migrate` theme primary election skips translucent overlays.** Primary/secondary are now elected from the most frequent non-neutral, **opaque** color across all usages (text/border/bg + interactive) instead of interactive backgrounds only — a translucent hover overlay could otherwise win (e.g. Electrolux came out `rgba(123,138,156,0.24)` instead of the brand navy). (#206)
|
|
19
|
+
|
|
20
|
+
## [0.18.0] — 2026-08-17
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
|
|
24
|
+
* **`parity migrate` — phased, target-agnostic migration capture (new command).** Single-site (no prod×cand) pipeline that produces a token-lean, agent-ready bundle + prompt for migrating a live storefront to a new stack. Three resumable phases: **theme + assets** (color/typography/spacing/radii token election, breakpoints from `@media`, motion tokens, plus brand assets — logo/favicon/apple-touch/OG/manifest/fonts — downloaded **through the browser** to bypass Akamai/CF bot 403s, and an icon inventory); **sitemap** (browser-routed page discovery + classification); **components** (reusing `extract`'s detector, structural dedupe, deterministic **Tailwind IR** + raw-CSS fallback, light interaction hints via CSSOM, and suggested e2e selectors). Token economy is first-class (lean tier vs full `manifest.json`, `×N` collapse, per-component files). (#194)
|
|
25
|
+
* **`--target faststore` playbook + `custom-theme.scss`.** Appends a FastStore v4 playbook (CLI commands, doc links, section/CMS structure, Phosphor icons) and emits a deterministic `custom-theme.scss` mapping brand tokens → `--fs-*` global tokens. FastStore v4 styles with SCSS design tokens + `data-fs-*` (not Tailwind). (#196)
|
|
26
|
+
* **Multi-viewport theme + per-viewport site screenshots** (`--viewports mobile,desktop`). (#197)
|
|
27
|
+
* **VTEX IO block-tree source + deterministic FastStore mapper.** For VTEX IO stores, reads the real declarative block tree from `window.__RUNTIME__` → `blocks.json` + `component-map.json` (`product-summary→ProductCard`, custom blocks → `custom-component`). Verified live on storetheme.vtex.com. (#198)
|
|
28
|
+
* **Platform-aware PDP discovery** for `migrate` — Salesforce Commerce `.html`/`Product-Show` product pages, with an action-endpoint rejection guard (Wishlist-Add/Cart-Add never treated as a PDP). (#200)
|
|
29
|
+
* **`salesforce-commerce` (Demandware) platform detection**, checked before the loose `fs-`/`vtex-` class heuristics (fixes Sephora BR mis-detected as `vtex`). (#199)
|
|
30
|
+
|
|
10
31
|
### Fixed
|
|
11
32
|
|
|
33
|
+
* **403 hardening: `migrate` Phase 2 discovery routes through the browser** instead of a bare node fetch that bot-protected stores 403 (was silently degrading to home-only). (#195)
|
|
12
34
|
* **`--fail-on` now gates the exit code on its own (issue #178).** The blocking-issue exit-1 check was gated behind `--ci`, which had no other effect in the codebase — a run with double-digit criticals exited 0 unless the caller also remembered `--ci`, even though `--fail-on` (default `critical`) was already parsed and ready. The check now always runs; `--ci` has been removed as dead weight (`parity audit` never had it and always gated on `--fail-on` alone, which is the pattern `parity run` now follows too).
|
|
13
35
|
* **`--pages`/`--pages-file` scoping documented, and no longer silently disable visual-diff in no-LLM environments (issue #178).** These flags only ever scoped the visual-diff/vitals-extra-pages passes, never the `flows` crawl — now documented in `--help`/`docs/cli.md`, and `parity run` prints a one-line warning when both an explicit page list and a flows crawl are active. Separately, `applySmartDefaults` (issue #71) used to force `noVisualDiff = true` whenever no LLM provider was configured, even when `--pages`/`--pages-file` was explicitly set — making the flag silently inert. Explicit page selection now still gets the prod/cand screenshot + pixelmatch heatmap capture without an LLM verdict.
|
|
14
36
|
* **`banner-aspect-ratio` no longer double-counts carousel boundary clones (issue #178).** Images marked `aria-hidden="true"` or `data-slider-clone` (or nested inside such a wrapper) — the decorative clones a hydration-safe infinite carousel renders at its boundaries — are now excluded from the banner census in `src/diff/dom.ts`, which previously produced false "candidate has N extra banners" findings.
|