@decocms/parity 0.27.0 → 0.28.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.
Files changed (3) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/dist/cli.js +163 -32
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/).
7
7
 
8
+ ## [0.28.0] — 2026-08-24
9
+
10
+ The Studio board stops being a one-way report: the client can now see the fixes
11
+ that landed and talk back on a card, and what they say enters the flow.
12
+
13
+ ### Added
14
+
15
+ * **`parity plan notes` — the client's input channel.** Reads the comments the
16
+ client leaves on a page's card (`TASK_BOARD_COMMENT_LIST`), so *"this product
17
+ card should match the Brazil site, not Ecuador"* becomes a proposed
18
+ `set-reference` + `set-status upgrade` — exactly what those exist for. `--post`
19
+ writes a confirmation back on the card so the client sees their note became a
20
+ decision; our comments are prefixed and skipped on the next read, so a
21
+ confirmation never returns as fresh input. Notes are **proposals**: `as-is` and
22
+ `upgrade` still need the user, since only they get to say "stop working on this".
23
+ * **Fix cards (`parity plan board --fixes <file>`).** Mirrors the fixes a client
24
+ would recognise as their own cards, with the PR URL in the description and
25
+ `closed` rendering as `done` — "we fixed X" without them reading GitHub. Scoped
26
+ on purpose: lint, bundle and infra findings bury the board that is supposed to
27
+ show progress.
28
+ * **`--repo <owner/name>`** stored on each card, so the board knows where the work
29
+ lives.
30
+
31
+ ### Changed
32
+
33
+ * **Cards are anchored by id, not title.** The card id is stored on the page
34
+ (`PlanPage.boardItemId`) and carried across a re-capture by `mergePlanDecisions`.
35
+ Without it, renaming a card orphaned the client's comments and the next sync
36
+ built a second board. Titles are now the plain page path — the previous
37
+ `[host] /path` prefix existed only because the item was thought to have no repo
38
+ field; it does.
39
+ * **Orchestrator: a `client-notes` step** at the start of each page cycle when the
40
+ board goes to the Studio — read notes, propose the plan change, ask, apply,
41
+ confirm on the card. A note that cannot be acted on is answered, never left
42
+ silently unread: the client is watching that card to know they were heard.
43
+ (`migration-orchestrator`)
44
+
8
45
  ## [0.27.0] — 2026-08-21
9
46
 
10
47
  ### Added
package/dist/cli.js CHANGED
@@ -63724,6 +63724,8 @@ function mergePlanDecisions(fresh, previous) {
63724
63724
  const prev2 = prevPages.get(page.path);
63725
63725
  if (prev2?.status && prev2.status !== "pending")
63726
63726
  page.status = prev2.status;
63727
+ if (prev2?.boardItemId)
63728
+ page.boardItemId = prev2.boardItemId;
63727
63729
  }
63728
63730
  return { plan: fresh, carried, droppedWithDecisions };
63729
63731
  }
@@ -63759,6 +63761,13 @@ function findPage(plan, path) {
63759
63761
  const target = norm(path);
63760
63762
  return plan.pages.find((p) => p.path === path) ?? plan.pages.find((p) => norm(p.path) === target) ?? null;
63761
63763
  }
63764
+ function setPageBoardItemId(plan, path, boardItemId) {
63765
+ const page = findPage(plan, path);
63766
+ if (!page)
63767
+ return null;
63768
+ page.boardItemId = boardItemId;
63769
+ return page;
63770
+ }
63762
63771
  function planProgress(plan) {
63763
63772
  const compByStatus = {
63764
63773
  pending: 0,
@@ -63912,7 +63921,8 @@ function planBoard(plan, candUrl) {
63912
63921
  column,
63913
63922
  blockers: (page.tasks ?? []).filter((t) => t.disposition === "build" && t.scope !== "global").map((t) => t.name),
63914
63923
  counts: page.counts,
63915
- ready: page.ready
63924
+ ready: page.ready,
63925
+ boardItemId: p.boardItemId
63916
63926
  });
63917
63927
  }
63918
63928
  const onAnyPage = new Set(plan.pages.flatMap((p) => (p.components ?? []).map(key)));
@@ -65221,6 +65231,7 @@ function sleep2(ms) {
65221
65231
  }
65222
65232
 
65223
65233
  // src/commands/plan.ts
65234
+ import { readFileSync as readFileSync21 } from "node:fs";
65224
65235
  import chalk18 from "chalk";
65225
65236
 
65226
65237
  // src/board/studio.ts
@@ -65239,9 +65250,10 @@ function studioConfigFromEnv(env = process.env) {
65239
65250
  return null;
65240
65251
  return { url: url.replace(/\/+$/, ""), token };
65241
65252
  }
65242
- function cardTitle(host, path) {
65243
- return `[${host}] ${path}`;
65253
+ function cardTitle(path) {
65254
+ return path;
65244
65255
  }
65256
+ var PARITY_COMMENT_PREFIX = "[parity]";
65245
65257
  function cardDescription(card) {
65246
65258
  const lines = [`kind: ${card.kind}`, `lane: ${card.column}`];
65247
65259
  if (card.blockers.length)
@@ -65292,11 +65304,27 @@ var callTool2 = async (cfg, name, args) => {
65292
65304
  }
65293
65305
  return result?.structuredContent ?? {};
65294
65306
  };
65295
- async function syncBoardToStudio(board, cfg, call = callTool2) {
65296
- const host = new URL(board.url).host;
65307
+ async function syncBoardToStudio(board, cfg, opts = {}, call = callTool2) {
65297
65308
  const existing = await call(cfg, "TASK_BOARD_ITEM_LIST", {});
65298
65309
  const byTitle = new Map((existing.items ?? []).map((i) => [i.title, i]));
65299
- const result = { created: 0, updated: 0, skipped: 0 };
65310
+ const byId = new Map((existing.items ?? []).map((i) => [i.id, i]));
65311
+ const result = { created: 0, updated: 0, skipped: 0, ids: {} };
65312
+ const upsert = async (title, description, status, knownId) => {
65313
+ const found = (knownId ? byId.get(knownId) : undefined) ?? byTitle.get(title);
65314
+ if (found) {
65315
+ await call(cfg, "TASK_BOARD_ITEM_UPDATE", { id: found.id, title, status, description });
65316
+ result.updated += 1;
65317
+ return found.id;
65318
+ }
65319
+ const created = await call(cfg, "TASK_BOARD_ITEM_CREATE", {
65320
+ title,
65321
+ description,
65322
+ status,
65323
+ ...opts.repo ? { repo: opts.repo } : {}
65324
+ });
65325
+ result.created += 1;
65326
+ return created.item?.id;
65327
+ };
65300
65328
  for (const cards of Object.values(board.columns)) {
65301
65329
  for (const card of cards) {
65302
65330
  const status = LANE_TO_STUDIO[card.column];
@@ -65304,20 +65332,58 @@ async function syncBoardToStudio(board, cfg, call = callTool2) {
65304
65332
  result.skipped += 1;
65305
65333
  continue;
65306
65334
  }
65307
- const title = cardTitle(host, card.path);
65308
- const description = cardDescription(card);
65309
- const found = byTitle.get(title);
65310
- if (found) {
65311
- await call(cfg, "TASK_BOARD_ITEM_UPDATE", { id: found.id, status, description });
65312
- result.updated += 1;
65313
- } else {
65314
- await call(cfg, "TASK_BOARD_ITEM_CREATE", { title, description, status });
65315
- result.created += 1;
65316
- }
65335
+ const id = await upsert(cardTitle(card.path), cardDescription(card), status, card.boardItemId);
65336
+ if (id)
65337
+ result.ids[card.path] = id;
65317
65338
  }
65318
65339
  }
65340
+ for (const fix of opts.fixes ?? []) {
65341
+ await upsert(fix.title, fixDescription(fix), FIX_STATE_TO_STUDIO[fix.state]);
65342
+ }
65319
65343
  return result;
65320
65344
  }
65345
+ async function fetchClientNotes(pages, cfg, call = callTool2) {
65346
+ const notes = [];
65347
+ for (const page of pages) {
65348
+ const res = await call(cfg, "TASK_BOARD_COMMENT_LIST", {
65349
+ taskBoardItemId: page.boardItemId
65350
+ });
65351
+ for (const c of res.comments ?? []) {
65352
+ if (c.body.trimStart().startsWith(PARITY_COMMENT_PREFIX))
65353
+ continue;
65354
+ if (c.resolved)
65355
+ continue;
65356
+ notes.push({
65357
+ path: page.path,
65358
+ boardItemId: page.boardItemId,
65359
+ commentId: c.id,
65360
+ body: c.body,
65361
+ createdAt: c.createdAt
65362
+ });
65363
+ }
65364
+ }
65365
+ return notes;
65366
+ }
65367
+ async function postParityComment(boardItemId, body, cfg, call = callTool2) {
65368
+ await call(cfg, "TASK_BOARD_COMMENT_CREATE", {
65369
+ taskBoardItemId: boardItemId,
65370
+ body: `${PARITY_COMMENT_PREFIX} ${body}`
65371
+ });
65372
+ }
65373
+ var FIX_STATE_TO_STUDIO = {
65374
+ open: "todo",
65375
+ in_review: "in_review",
65376
+ closed: "done"
65377
+ };
65378
+ function fixDescription(fix) {
65379
+ const lines = [];
65380
+ if (fix.body)
65381
+ lines.push(fix.body);
65382
+ if (fix.prUrl)
65383
+ lines.push(`PR: ${fix.prUrl}`);
65384
+ return lines.join(`
65385
+ `);
65386
+ }
65321
65387
 
65322
65388
  // src/commands/plan.ts
65323
65389
  var STATUSES = ["pending", "partial", "done", "as-is", "upgrade", "skipped"];
@@ -65582,7 +65648,15 @@ ${chalk18.bold("no page")} ${chalk18.gray("(in the code, not seen on any sampled
65582
65648
  return 0;
65583
65649
  }
65584
65650
  try {
65585
- const synced = await syncBoardToStudio(board, cfg);
65651
+ const fixes = opts.fixes ? JSON.parse(readFileSync21(opts.fixes, "utf8")) : undefined;
65652
+ const synced = await syncBoardToStudio(board, cfg, { repo: opts.repo, fixes });
65653
+ let stored = 0;
65654
+ for (const [path, id] of Object.entries(synced.ids)) {
65655
+ if (setPageBoardItemId(plan, path, id))
65656
+ stored += 1;
65657
+ }
65658
+ if (stored)
65659
+ savePlan(dir, plan);
65586
65660
  console.log(chalk18.green(`Studio board synced — ${synced.created} created, ${synced.updated} updated, ${synced.skipped} skipped.
65587
65661
  `));
65588
65662
  } catch (err) {
@@ -65592,14 +65666,63 @@ ${chalk18.bold("no page")} ${chalk18.gray("(in the code, not seen on any sampled
65592
65666
  }
65593
65667
  return 0;
65594
65668
  }
65669
+ async function planNotesCommand(dir, opts) {
65670
+ const plan = loadPlan(dir);
65671
+ if (!plan) {
65672
+ console.error(chalk18.red(`No migration-plan.json found in ${dir}`));
65673
+ return 1;
65674
+ }
65675
+ const cfg = studioConfigFromEnv();
65676
+ if (!cfg) {
65677
+ console.error(chalk18.yellow("Studio not configured — set PARITY_STUDIO_URL and PARITY_STUDIO_TOKEN."));
65678
+ return 1;
65679
+ }
65680
+ if (opts.post) {
65681
+ const page = plan.pages.find((p) => p.path === opts.page);
65682
+ if (!page?.boardItemId) {
65683
+ console.error(chalk18.red(`No synced card for page "${opts.page}" — run \`parity plan board --board studio\` first`));
65684
+ return 1;
65685
+ }
65686
+ await postParityComment(page.boardItemId, opts.post, cfg);
65687
+ console.log(`${chalk18.green("✓")} comment posted on ${page.path}`);
65688
+ return 0;
65689
+ }
65690
+ const pages = plan.pages.filter((p) => p.boardItemId).filter((p) => !opts.page || p.path === opts.page).map((p) => ({ path: p.path, boardItemId: p.boardItemId }));
65691
+ if (!pages.length) {
65692
+ console.error(chalk18.yellow("No page has a synced card yet — run `parity plan board --board studio` first."));
65693
+ return 1;
65694
+ }
65695
+ const notes = await fetchClientNotes(pages, cfg);
65696
+ if (opts.json) {
65697
+ console.log(JSON.stringify({ notes }, null, 2));
65698
+ return 0;
65699
+ }
65700
+ if (!notes.length) {
65701
+ console.log(chalk18.gray(`
65702
+ No open client notes.
65703
+ `));
65704
+ return 0;
65705
+ }
65706
+ console.log(chalk18.bold(`
65707
+ Client notes (${notes.length})`));
65708
+ for (const n of notes) {
65709
+ console.log(`
65710
+ ${chalk18.cyan(n.path)} ${chalk18.gray(n.createdAt)}`);
65711
+ for (const line of n.body.split(`
65712
+ `))
65713
+ console.log(` ${line}`);
65714
+ }
65715
+ console.log(chalk18.gray('\nThese are PROPOSALS. Apply with `parity plan set-reference` / `set-status`, then confirm with `parity plan notes --page <path> --post "<what you did>"`.\n'));
65716
+ return 0;
65717
+ }
65595
65718
 
65596
65719
  // src/commands/pr.ts
65597
- import { existsSync as existsSync19, readFileSync as readFileSync23, writeFileSync as writeFileSync25 } from "node:fs";
65720
+ import { existsSync as existsSync19, readFileSync as readFileSync24, writeFileSync as writeFileSync25 } from "node:fs";
65598
65721
  import { join as join30 } from "node:path";
65599
65722
  import chalk21 from "chalk";
65600
65723
 
65601
65724
  // src/commands/run.ts
65602
- import { existsSync as existsSync18, readFileSync as readFileSync22, unlinkSync as unlinkSync3 } from "node:fs";
65725
+ import { existsSync as existsSync18, readFileSync as readFileSync23, unlinkSync as unlinkSync3 } from "node:fs";
65603
65726
  import { join as join29 } from "node:path";
65604
65727
  import chalk20 from "chalk";
65605
65728
  import ora7 from "ora";
@@ -66142,7 +66265,7 @@ import { existsSync as existsSync17 } from "node:fs";
66142
66265
  import chalk19 from "chalk";
66143
66266
 
66144
66267
  // src/server/proxy-server.ts
66145
- import { existsSync as existsSync16, readFileSync as readFileSync21, statSync } from "node:fs";
66268
+ import { existsSync as existsSync16, readFileSync as readFileSync22, statSync } from "node:fs";
66146
66269
  import { createServer } from "node:http";
66147
66270
  import { extname, join as join28, normalize as normalize3, resolve as resolve5, sep } from "node:path";
66148
66271
  var MIME3 = {
@@ -66244,7 +66367,7 @@ function serveReportHtml(res, runDir) {
66244
66367
  res.end("report.html not found");
66245
66368
  return;
66246
66369
  }
66247
- const html3 = readFileSync21(filePath, "utf8");
66370
+ const html3 = readFileSync22(filePath, "utf8");
66248
66371
  const inject = `<script>window.__parity_proxy = "/proxy?url=";</script>`;
66249
66372
  const out = html3.includes("</head>") ? html3.replace("</head>", `${inject}</head>`) : `${inject}${html3}`;
66250
66373
  res.statusCode = 200;
@@ -66275,7 +66398,7 @@ function serveStatic(res, runDir, path) {
66275
66398
  res.statusCode = 200;
66276
66399
  res.setHeader("content-type", MIME3[ext] ?? "application/octet-stream");
66277
66400
  res.setHeader("cache-control", "no-store");
66278
- res.end(readFileSync21(filePath));
66401
+ res.end(readFileSync22(filePath));
66279
66402
  }
66280
66403
  async function proxyRequest(req, res, targetUrl, opts = {}) {
66281
66404
  let target;
@@ -67388,7 +67511,7 @@ function resolveExplicitPages(pagesFile, pagesList) {
67388
67511
  if (!existsSync18(pagesFile)) {
67389
67512
  throw new Error(`--pages-file não encontrado: ${pagesFile}`);
67390
67513
  }
67391
- const raw = readFileSync22(pagesFile, "utf-8");
67514
+ const raw = readFileSync23(pagesFile, "utf-8");
67392
67515
  const lines = raw.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
67393
67516
  return lines.map(parsePagePair);
67394
67517
  }
@@ -67619,7 +67742,7 @@ async function prCommand(opts) {
67619
67742
  console.error(chalk21.red(`report.json not found at ${reportJsonPath}`));
67620
67743
  return runCode || 1;
67621
67744
  }
67622
- const run = JSON.parse(readFileSync23(reportJsonPath, "utf8"));
67745
+ const run = JSON.parse(readFileSync24(reportJsonPath, "utf8"));
67623
67746
  const markdown = buildPrComment(run, opts);
67624
67747
  if (opts.out) {
67625
67748
  writeFileSync25(opts.out, markdown, "utf8");
@@ -67720,7 +67843,7 @@ function promptCommand(runId, opts) {
67720
67843
  }
67721
67844
 
67722
67845
  // src/commands/report.ts
67723
- import { existsSync as existsSync21, readFileSync as readFileSync24, writeFileSync as writeFileSync27 } from "node:fs";
67846
+ import { existsSync as existsSync21, readFileSync as readFileSync25, writeFileSync as writeFileSync27 } from "node:fs";
67724
67847
  import { join as join31 } from "node:path";
67725
67848
  import chalk23 from "chalk";
67726
67849
  import open2 from "open";
@@ -68352,7 +68475,7 @@ async function reportCommand(runId, opts) {
68352
68475
  console.error(chalk23.red(`report.html not found at ${paths.reportHtml}`));
68353
68476
  return 1;
68354
68477
  }
68355
- const html3 = readFileSync24(paths.reportHtml, "utf8");
68478
+ const html3 = readFileSync25(paths.reportHtml, "utf8");
68356
68479
  const slice2 = extractReportSection({ kind: "html", section: opts.section, html: html3 });
68357
68480
  if (slice2 === null) {
68358
68481
  console.error(chalk23.red(`section "${opts.section}" not present in this report`));
@@ -68369,7 +68492,7 @@ async function reportCommand(runId, opts) {
68369
68492
  }
68370
68493
 
68371
68494
  // src/commands/vitals.ts
68372
- import { existsSync as existsSync22, readFileSync as readFileSync25, writeFileSync as writeFileSync28 } from "node:fs";
68495
+ import { existsSync as existsSync22, readFileSync as readFileSync26, writeFileSync as writeFileSync28 } from "node:fs";
68373
68496
  import { availableParallelism } from "node:os";
68374
68497
  import { join as join32 } from "node:path";
68375
68498
  import chalk24 from "chalk";
@@ -68906,7 +69029,7 @@ function parseUrlList(input) {
68906
69029
  if (input.startsWith("file:") || input.endsWith(".txt") || input.endsWith(".list")) {
68907
69030
  const path = input.replace(/^file:\/\//, "");
68908
69031
  if (existsSync22(path)) {
68909
- return readFileSync25(path, "utf8").split(/\r?\n/).map((s) => s.trim()).filter((s) => s && !s.startsWith("#")).map((s) => s.startsWith("/") ? s : `/${s}`);
69032
+ return readFileSync26(path, "utf8").split(/\r?\n/).map((s) => s.trim()).filter((s) => s && !s.startsWith("#")).map((s) => s.startsWith("/") ? s : `/${s}`);
68910
69033
  }
68911
69034
  }
68912
69035
  return input.split(",").map((s) => s.trim()).filter(Boolean).map((s) => s.startsWith("/") || s.startsWith("http") ? s : `/${s}`);
@@ -68936,7 +69059,7 @@ function printSummary7(vitals, cache, scores, opportunities, agentic) {
68936
69059
  }
68937
69060
 
68938
69061
  // src/util/version.ts
68939
- import { readFileSync as readFileSync26 } from "node:fs";
69062
+ import { readFileSync as readFileSync27 } from "node:fs";
68940
69063
  import { dirname as dirname5, resolve as resolve6 } from "node:path";
68941
69064
  import { fileURLToPath } from "node:url";
68942
69065
  function getPackageVersion() {
@@ -68945,7 +69068,7 @@ function getPackageVersion() {
68945
69068
  for (const up of ["..", "../..", "../../.."]) {
68946
69069
  try {
68947
69070
  const pkgPath = resolve6(here, up, "package.json");
68948
- const raw = readFileSync26(pkgPath, "utf8");
69071
+ const raw = readFileSync27(pkgPath, "utf8");
68949
69072
  const parsed = JSON.parse(raw);
68950
69073
  if (parsed.name === "@decocms/parity" && typeof parsed.version === "string") {
68951
69074
  return parsed.version;
@@ -69013,11 +69136,19 @@ program.command("plan").description("Inspect/update the migration-plan.json comp
69013
69136
  process.exit(planStatusCommand(opts.dir, Boolean(opts.json)));
69014
69137
  })).addCommand(new Command("page").description("Per-page worksheet: every component the capture saw on this page, what to do about it (build | validate | upgrade | as-is | settled), and a runnable `parity section` command for the checkable ones. The unit of work a migration closes is a page, not a global queue.").argument("<path>", "Page path, e.g. / or /refrigeracion").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)", ".parity").option("--cand <url>", "Candidate base URL — required for runnable validation commands").option("--json", "Emit structured JSON instead of human-readable text", false).action((path, opts) => {
69015
69138
  process.exit(planPageCommand(opts.dir, path, { cand: opts.cand, json: Boolean(opts.json) }));
69016
- })).addCommand(new Command("board").description("Per-page kanban: every sampled page in a derived lane (triage | backlog | building | review | done) with what blocks it. Lanes come from each page's components, so a page cannot read as done while a component it needs is missing.").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)", ".parity").option("--cand <url>", "Candidate base URL — enriches cards with validation state").option("--board <where>", "terminal (default) | studio — push one card per page to the deco Studio task board (needs PARITY_STUDIO_URL + PARITY_STUDIO_TOKEN; falls back to terminal when unset or unreachable)", "terminal").option("--json", "Emit structured JSON instead of human-readable text", false).action(async (opts) => {
69139
+ })).addCommand(new Command("board").description("Per-page kanban: every sampled page in a derived lane (triage | backlog | building | review | done) with what blocks it. Lanes come from each page's components, so a page cannot read as done while a component it needs is missing.").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)", ".parity").option("--cand <url>", "Candidate base URL — enriches cards with validation state").option("--board <where>", "terminal (default) | studio — push one card per page to the deco Studio task board (needs PARITY_STUDIO_URL + PARITY_STUDIO_TOKEN; falls back to terminal when unset or unreachable)", "terminal").option("--repo <owner/name>", "Repository stored on each card, so the board knows where the work lives").option("--fixes <path>", "JSON file of client-legible fixes to mirror as cards: [{title, body?, prUrl?, state: open|in_review|closed}]").option("--json", "Emit structured JSON instead of human-readable text", false).action(async (opts) => {
69017
69140
  process.exit(await planBoardCommand(opts.dir, {
69018
69141
  cand: opts.cand,
69019
69142
  json: Boolean(opts.json),
69020
- board: opts.board
69143
+ board: opts.board,
69144
+ repo: opts.repo,
69145
+ fixes: opts.fixes
69146
+ }));
69147
+ })).addCommand(new Command("notes").description("Read the client's comments off the Studio cards — the input channel for 'compare this component against site X instead'. They are proposals: apply with set-reference/set-status, then --post a confirmation back.").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)", ".parity").option("--page <path>", "Only this page").option("--post <body>", "Post a confirmation comment on --page instead of reading").option("--json", "Emit structured JSON instead of human-readable text", false).action(async (opts) => {
69148
+ process.exit(await planNotesCommand(opts.dir, {
69149
+ json: Boolean(opts.json),
69150
+ page: opts.page,
69151
+ post: opts.post
69021
69152
  }));
69022
69153
  })).addCommand(new Command("set-reference").description("Point a component's comparison at something other than prod (a site the better component came from), and record WHY it diverges. Without this, an intentional improvement is reported as a defect on every run.").argument("<name>", "Component name (case- and separator-insensitive)").requiredOption("--note <why>", "Why this component diverges — required, not decoration").option("--url <url>", "Reference site base URL (default: the plan's prod URL)").option("--selector <sel>", "Selector on the reference site, when it differs").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)", ".parity").action((name, opts) => {
69023
69154
  process.exit(planSetReferenceCommand(opts.dir, name, {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@decocms/parity",
3
- "version": "0.27.0",
3
+ "version": "0.28.0",
4
4
  "description": "E2E parity validator for site migrations. Compares prod vs cand and reports UI, functional, SEO, visual, and Web Vitals deltas with an LLM-ranked HTML report.",
5
5
  "type": "module",
6
6
  "license": "MIT",