@nextcommerce/campaigns-os 1.62.0 → 1.66.0

package/CHANGELOG.md

@@ -2,6 +2,77 @@
 
 Notable supported-surface changes are recorded here.
 
+## [1.66.0] - 2026-11-07
+
+Funnels handed off before 1.62.0 can now reach small checks without a test order. To take it, pin `@nextcommerce/campaigns-os@1.66.0`. Nothing changes for a funnel unless a named person runs the new command.
+
+### Added
+
+- **`record baseline` (#716).** `campaigns-os record baseline --packet <packet> --accepted-by "<named person>" --reason "<why>"` accepts a handed-off funnel from before markup hashes as the starting point, one time per funnel. It tests nothing and places no orders. After it, a page-only change owes QA on that page alone, and a commerce-affecting change still owes the full Polish and QA. It refuses a funnel whose last QA was blocked, one where no QA ever completed, one whose records have markup hashes, and one where no full QA is owed.
+- **The stage status `baseline_accepted`.** Polish and QA take it from `record baseline`. It ends the ladder, so `next` moves on, but it is never `completed` and never hands a campaign off. What those stages held moves to history, so its purchase proof stops counting. A passing `qa run --page` leaves QA at this status, and only a completed full QA ends it. Progress snapshots read it as `unknown`.
+- **Reports say what it is.** Doctor warns `qa.baseline_accepted`, and `doctor --ci`, readback and `next` say QA rests on a baseline and no purchase has been tested since. `evidence_debt.qa` gains `baseline`, and the Assembly Report gains a top-level `commerce_baseline`, which keeps the status, warnings and skip reason of what it replaced.
+
+## [1.65.0+agent.1] - 2026-11-07
+
+Commercial parity now checks `package.price` as well as `bundle.*.price`. Starter upsells use `package.price`, so a funnel could pass every calculate scenario with no printed price compared. No pin change is needed to read verdicts; the behavior ships in the next release.
+
+### Changed
+
+- **`package.price` and `package.<ref>.price` are compared as rendered.** Under `qa run --browser`, each visible node the SDK has filled is compared with calculate's `unit_price` for that package's row on the page. The source holds a template placeholder (`$9.99` on a starter upsell), so the source text is never compared. A difference is the existing warn-only `price-claim-mismatch`. That includes a page printing `package.price`, the list price, beside a live offer.
+- **What cannot be compared is named.** A run without `--browser`, a rendered page that showed none of the claims, a visible node the SDK never wrote, or a claim with no package id, no single exact row or unreadable text each writes a `commercial-parity:incomplete:<code>` warn row and never a mismatch. A run without `--browser` on a page with these claims now reads `incomplete`, so it stays at `ready_with_exceptions`.
+- `verdict.commercial.package_price_claims` counts these claims, and they count toward `extracted_price_claims`, `compared_price_claims` and `unresolved_price_claims`. Journey rows from the `./commercial-journey` export carry `unit_price` when calculate sends it, and captures from `./commercial-parity` carry `package_price_claims`.
+
+## [1.65.0] - 2026-11-07
+
+A QA run whose commercial parity stopped short no longer reads as a clean result. Commercial status `incomplete` now keeps the verdict at `ready_with_exceptions` and names the cause and the fix in `exceptions[]`. It stays warn-only: nothing new blocks, and the exit code does not change. To take it, pin `@nextcommerce/campaigns-os@1.65.0` and refresh the installed skills to `1.65.0+skills.1`.
+
+### Changed
+
+- **Incomplete commercial coverage is an exception.** A spec with no `campaign.campaigns_api_key`, for example, used to run 0 of its calculate scenarios and could still report `ready`, with the gap visible only under `verdict.commercial`. The verdict is now `ready_with_exceptions`, with a warn row `commercial-parity:incomplete:missing_campaigns_api_key` whose `actual` says what was not compared and how to fix it.
+  - A cause an earlier one already explains writes no second row, so a missing key does not also report every page as unpriced. Read the row for what to do: the set of codes is not a contract.
+  - Not every cause has a repair. A store coupon, two bound prices on one page, a run in a currency other than the Map's and a funnel over the check's limits say what this run did not compare, and these runs stay at `ready_with_exceptions`.
+  - The committed sidecar keeps the row's id, which names the cause. The verdict's `commercial` section gains `incomplete_reasons` with the same causes, and `qa run` prints them under its commercial line.
+  - A run that was `ready` only because the gap was invisible now records its QA stage as `completed_with_warnings`, and its Run Record lists `pricing` among its gap classes. Both dispositions still end a run session.
+- **A crash in the commercial check is reported the same way.** It used to leave status `not_run` and the verdict untouched, with a line on stderr. It now reads `incomplete` with the cause `commercial_runner_error`. Runs a gate blocks keep `not_run`, since those verdicts are already `blocked`.
+- The verdict schema's `disposition` and `commercial.status` descriptions say the above, and it documents `commercial.incomplete_reasons`.
+
+## [1.64.0] - 2026-11-07
+
+Developers changing a live funnel from a fresh clone can now get going, and the reports say what they compared. To take it, pin `@nextcommerce/campaigns-os@1.64.0`, run `spec fetch` once on each repository set up from a saved Map, and commit the file it writes. These come from the first post-handoff trial on #716.
+
+### Added
+
+- **`spec fetch` (#716).** `campaigns-os spec fetch --packet <packet>` restores a saved-Map packet's CampaignSpec on a checkout that lacks it, by the same fetch intake makes. It never replaces a copy on disk, because that copy can hold `spec derive` edits the Map doesn't have, and it doesn't write the packet or the records. Its `bound` result says whether the copy matches the spec the records were made against. A doctor `spec.local_path` error for a missing Map copy now names the command.
+- **`built_output.absent` doctor warning (#716).** When the build stage is complete and `_site/<route>/` isn't there, doctor says the records were not compared with this checkout, and `next` says so at `done`. A fresh clone used to read as finished however much source had moved.
+
+### Changed
+
+- **The fetched CampaignSpec is committed (#716).** `.campaign-runtime/fetched-specs/` leaves the managed `.gitignore` block, and an existing block loses the line on the next setup command or `spec fetch`. The committed records are bound to this file and `spec derive` writes into it, so another machine can't rebuild it from the Map once it has been derived.
+- **`doctor --ci` names what it compared (#716).** Each owed stage's report line gives the build it last checked, with the date when QA completed. When the latest change alone is page-only but an earlier rebuild since that check wasn't, the report names that rebuild, so it no longer seems to contradict `record build`. `evidence_debt.<stage>.change` gains `commerce_rebuild`, and `evidence_debt.qa` gains `reviewed_at` when QA completed, each only when there is a value.
+- **Clearer wording for a pre-1.62 build (#716).** `commerce_signature_unavailable` now reads as a build from before the markup hashes existed.
+
+### Fixed
+
+- **The docs on pre-1.62 records (#716).** They said such a change reads as `unknown` until `record build` records a signature. It reads as `commerce_affecting`, and `record build` doesn't clear it. Page-only changes start after one full QA on 1.62.0 or later, and the docs now say so.
+
+## [1.63.0+agent.1] - 2026-11-02
+
+The `PagePackage` type accepts `prices: null`, as the schemas and the `PackageCurrencyPrices` rule already did. No pin change is needed to read specs; TypeScript callers that pass `null` stop failing type checks on the next release.
+
+### Fixed
+
+- `PagePackage.prices` is typed `PackageCurrencyPrice[] | null`, like the package's other nullable fields. Schemas v4 and v5 allow `null`, and the rule treats it as absent, so a spec that validated could fail to type-check. (#714)
+- The authoring guide's `prices[]` section says to refresh the Map after any price change: `spec derive` refreshes `price` and `price_retail` but not `prices[]`, so a default-currency change otherwise leaves `price` and that currency's `prices[]` entry disagreeing.
+
+## [1.63.0] - 2026-10-31
+
+CampaignSpec can carry a page package's price in each currency the campaign sells in, and validation warns when a package has no price in one of them. To take it, pin `@nextcommerce/campaigns-os@1.63.0` and refresh the installed skills to `1.63.0+skills.1`; the skill text changes only in its stated revision.
+
+### Added
+
+- **`prices[]` on a page package (#714).** A row in `funnels[].pages[].packages[]` may carry `prices: [{ currency, price, price_retail?, price_recurring? }]`, one entry per currency the Campaigns App prices the package in, read from the Campaigns API in that currency (`GET /campaigns/?currency=<code>`). `price` and `price_retail` stay the default currency's. The field is optional and additive in schemas v4 and v5 and in the `PagePackage` type (with `PackageCurrencyPrice`), and the authoring guide's Campaign Currencies section shows it.
+- **`PackageCurrencyPrices` rule (#714).** A warning, tagged `fast` and `spec-only`, so `doctor` and Map Builder both run it. For a row that carries `prices[]`, it reports a currency in `campaign.available_currencies` or `campaign.currency` with no entry, since the Campaigns API leaves an unpriced package out of the campaign in that currency; an entry without an ISO 4217 `currency` and a non-negative decimal `price`, or with a malformed `price_retail` or `price_recurring`; and a currency listed twice. A row without `prices[]` (absent or null) is not checked, and malformed campaign currency codes stay with `CampaignCurrencies`.
+
 ## [1.62.0] - 2026-10-30
 
 This release makes the path from a Map to a working campaign shorter to start and cheaper to maintain. CampaignSpec validation catches a checkout nothing sells into and malformed currencies, and it carries the starter templates' analytics vendors. One project can hold several funnels. After handoff, `spec derive` keeps the spec in step with the repo's pages and the live campaign. A change to some pages' copy owes QA on those pages only. `qa run --test-order` holds test purchases back from the analytics vendors it can intercept (all of the template vendors except Northbeam), and `qa run --currency` blocks when the currency did not take. To take it, pin `@nextcommerce/campaigns-os@1.62.0` and refresh the installed skills to `1.62.0+skills.1`.

package/campaign-spec/dist/rules/campaign-currencies.d.ts

@@ -26,4 +26,5 @@
  * (very old browsers) gets the shape check only.
  */
 import type { Rule } from '../types.ts';
+export declare function isCurrencyCode(value: unknown): value is string;
 export declare const CampaignCurrencies: Rule;

package/campaign-spec/dist/rules/campaign-currencies.js

@@ -34,7 +34,7 @@ function knownIsoCodes() {
     }
     return isoCodes;
 }
-function isCurrencyCode(value) {
+export function isCurrencyCode(value) {
     if (typeof value !== 'string' || !CODE_SHAPE.test(value))
         return false;
     const known = knownIsoCodes();

package/campaign-spec/dist/rules/index.d.ts

@@ -42,6 +42,7 @@ export { PackagePricingSanity } from './package-pricing-sanity.ts';
 export { ShippingMethodsPresent } from './shipping-methods-present.ts';
 export { ShippingCountriesShape } from './shipping-countries-shape.ts';
 export { CampaignCurrencies } from './campaign-currencies.ts';
+export { PackageCurrencyPrices } from './package-currency-prices.ts';
 export { OfferRefIntegrity } from './offer-ref-integrity.ts';
 export { ExitIntentValidation } from './exit-intent-validation.ts';
 export { PromoCodeInputValidation } from './promo-code-input-validation.ts';

package/campaign-spec/dist/rules/index.js

@@ -41,6 +41,7 @@ import { CampaignMetadata } from "./campaign-metadata.js";
 import { ShippingMethodsPresent } from "./shipping-methods-present.js";
 import { ShippingCountriesShape } from "./shipping-countries-shape.js";
 import { CampaignCurrencies } from "./campaign-currencies.js";
+import { PackageCurrencyPrices } from "./package-currency-prices.js";
 import { PackagePricingSanity } from "./package-pricing-sanity.js";
 import { OfferRefIntegrity } from "./offer-ref-integrity.js";
 import { ExitIntentValidation } from "./exit-intent-validation.js";
@@ -78,6 +79,7 @@ export { PackagePricingSanity } from "./package-pricing-sanity.js";
 export { ShippingMethodsPresent } from "./shipping-methods-present.js";
 export { ShippingCountriesShape } from "./shipping-countries-shape.js";
 export { CampaignCurrencies } from "./campaign-currencies.js";
+export { PackageCurrencyPrices } from "./package-currency-prices.js";
 export { OfferRefIntegrity } from "./offer-ref-integrity.js";
 export { ExitIntentValidation } from "./exit-intent-validation.js";
 export { PromoCodeInputValidation } from "./promo-code-input-validation.js";
@@ -125,6 +127,7 @@ export const allRules = [
     ShippingMethodsPresent,
     ShippingCountriesShape,
     CampaignCurrencies,
+    PackageCurrencyPrices,
     OfferRefIntegrity,
     ExitIntentValidation,
     PromoCodeInputValidation,

package/campaign-spec/dist/rules/package-currency-prices.d.ts

@@ -0,0 +1,29 @@
+/**
+ * PackageCurrencyPrices — checks each page package's price in every currency
+ * the campaign sells in (#714).
+ *
+ * A package row may carry `prices[]`: one `{ currency, price, price_retail?,
+ * price_recurring? }` per currency the Campaigns App has a price for, read
+ * from the Campaigns API (`GET /campaigns/?currency=<code>`). That read
+ * returns only the packages priced in the requested currency, so a package
+ * with no price in a listed currency is missing from the campaign for a
+ * shopper paying in it.
+ *
+ *   1. `prices`, when present, is an array of entries, each with a
+ *      three-letter upper-case ISO 4217 `currency` and a non-negative
+ *      numeric `price`, and no currency twice.
+ *   2. A row with `prices` has an entry for every currency in
+ *      campaign.available_currencies and for campaign.currency.
+ *
+ * A row without `prices` (absent or null) is silent: older Maps and
+ * hand-written specs carry the default currency's price only (`price`), and
+ * nothing is known about the others. Every finding is a warning, since a
+ * missing price is fixed in the Campaigns App, not in the spec.
+ *
+ * The selling currencies are the spec's own `campaign.currency` and
+ * `campaign.available_currencies`. The Campaigns App API's
+ * `additional_currencies` is not a CampaignSpec field (CampaignCurrencies), so
+ * it is not read here either.
+ */
+import type { Rule } from '../types.ts';
+export declare const PackageCurrencyPrices: Rule;

package/campaign-spec/dist/rules/package-currency-prices.js

@@ -0,0 +1,137 @@
+/**
+ * PackageCurrencyPrices — checks each page package's price in every currency
+ * the campaign sells in (#714).
+ *
+ * A package row may carry `prices[]`: one `{ currency, price, price_retail?,
+ * price_recurring? }` per currency the Campaigns App has a price for, read
+ * from the Campaigns API (`GET /campaigns/?currency=<code>`). That read
+ * returns only the packages priced in the requested currency, so a package
+ * with no price in a listed currency is missing from the campaign for a
+ * shopper paying in it.
+ *
+ *   1. `prices`, when present, is an array of entries, each with a
+ *      three-letter upper-case ISO 4217 `currency` and a non-negative
+ *      numeric `price`, and no currency twice.
+ *   2. A row with `prices` has an entry for every currency in
+ *      campaign.available_currencies and for campaign.currency.
+ *
+ * A row without `prices` (absent or null) is silent: older Maps and
+ * hand-written specs carry the default currency's price only (`price`), and
+ * nothing is known about the others. Every finding is a warning, since a
+ * missing price is fixed in the Campaigns App, not in the spec.
+ *
+ * The selling currencies are the spec's own `campaign.currency` and
+ * `campaign.available_currencies`. The Campaigns App API's
+ * `additional_currencies` is not a CampaignSpec field (CampaignCurrencies), so
+ * it is not read here either.
+ */
+import { isCurrencyCode } from "./campaign-currencies.js";
+// A non-negative amount: a finite number, or a plain decimal string ("49.99").
+// Hex, binary and exponent strings ("0x10", "1e3") are not prices.
+function isPrice(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) && value >= 0;
+    return typeof value === 'string' && /^\d+(\.\d+)?$/.test(value.trim());
+}
+// An optional amount: absent, null, or a price.
+function isOptionalPrice(value) {
+    return value === undefined || value === null || isPrice(value);
+}
+// What is wrong with one prices[] entry, or null when it is well formed.
+function entryDefect(entry) {
+    if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+        return 'is not a { currency, price } object';
+    const row = entry;
+    const defects = [];
+    if (!isCurrencyCode(row.currency))
+        defects.push('a three-letter upper-case ISO 4217 currency');
+    if (!isPrice(row.price))
+        defects.push('a non-negative decimal price');
+    for (const field of ['price_retail', 'price_recurring']) {
+        if (!isOptionalPrice(row[field]))
+            defects.push(`a non-negative decimal ${field} (or none)`);
+    }
+    return defects.length ? `needs ${defects.join(' and ')}` : null;
+}
+// The currencies the campaign sells in: the valid listed codes and a valid
+// default. Malformed codes are CampaignCurrencies' to report.
+function sellingCurrencies(spec) {
+    const campaign = spec.campaign;
+    if (!campaign || typeof campaign !== 'object')
+        return [];
+    const listed = Array.isArray(campaign.available_currencies) ? campaign.available_currencies : [];
+    return [...new Set([campaign.currency, ...listed].filter(isCurrencyCode))];
+}
+export const PackageCurrencyPrices = {
+    id: 'PackageCurrencyPrices',
+    severity: 'warning',
+    tags: ['fast', 'spec-only'],
+    check(spec) {
+        const violations = [];
+        const selling = sellingCurrencies(spec);
+        spec.funnels.forEach((funnel, funnelIdx) => {
+            ;
+            (funnel.pages ?? []).forEach((page, pageIdx) => {
+                ;
+                (page.packages ?? []).forEach((pkg, pkgIdx) => {
+                    const prices = pkg.prices;
+                    if (prices === undefined || prices === null)
+                        return;
+                    const path = `/funnels/${funnelIdx}/pages/${pageIdx}/packages/${pkgIdx}/prices`;
+                    const name = pkg.name || pkg.ref_id;
+                    const label = `"${page.label || page.id}" — Package "${name}"`;
+                    if (!Array.isArray(prices)) {
+                        violations.push({
+                            ruleId: 'PackageCurrencyPrices',
+                            severity: 'warning',
+                            message: `${label}: prices must be an array of { currency, price } entries.`,
+                            path,
+                            data: { check: 'prices_shape', pageId: page.id, ref_id: pkg.ref_id, received: prices },
+                        });
+                        return;
+                    }
+                    const seen = new Set();
+                    prices.forEach((entry, index) => {
+                        const currency = entry && typeof entry === 'object' && !Array.isArray(entry) ? entry.currency : undefined;
+                        const defect = entryDefect(entry);
+                        // A malformed entry with a valid currency still counts that
+                        // currency as listed: the entry's own finding names the fix, and a
+                        // second "has no EUR price" finding would report it twice.
+                        if (defect) {
+                            violations.push({
+                                ruleId: 'PackageCurrencyPrices',
+                                severity: 'warning',
+                                message: `${label}: prices[${index}] ${defect}.`,
+                                path: `${path}/${index}`,
+                                data: { check: 'price_entry_shape', pageId: page.id, ref_id: pkg.ref_id, received: entry },
+                            });
+                        }
+                        else if (isCurrencyCode(currency) && seen.has(currency)) {
+                            violations.push({
+                                ruleId: 'PackageCurrencyPrices',
+                                severity: 'warning',
+                                message: `${label}: prices lists ${currency} more than once.`,
+                                path: `${path}/${index}`,
+                                data: { check: 'price_currency_repeated', pageId: page.id, ref_id: pkg.ref_id, currency },
+                            });
+                        }
+                        if (isCurrencyCode(currency))
+                            seen.add(currency);
+                    });
+                    const missing = selling.filter((code) => !seen.has(code));
+                    if (missing.length > 0) {
+                        const list = missing.length === 1 ? missing[0] : `${missing.slice(0, -1).join(', ')} or ${missing[missing.length - 1]}`;
+                        violations.push({
+                            ruleId: 'PackageCurrencyPrices',
+                            severity: 'warning',
+                            message: `${label} has no ${list} price, so the campaign leaves it out in ${missing.length === 1 ? 'that currency' : 'those currencies'}. Add the price in the Campaigns App, then refresh the Map.`,
+                            path,
+                            data: { check: 'price_currency_missing', pageId: page.id, ref_id: pkg.ref_id, missing },
+                        });
+                    }
+                });
+            });
+        });
+        return violations;
+    },
+};

package/campaign-spec/dist/types.d.ts

@@ -108,6 +108,14 @@ export interface PageOffer {
     benefit?: OfferBenefit;
     [key: string]: unknown;
 }
+/** One currency's price for a page package (#714). */
+export interface PackageCurrencyPrice {
+    /** Three-letter upper-case ISO 4217 code. */
+    currency: string;
+    price: number | string;
+    price_retail?: number | string | null;
+    price_recurring?: number | string | null;
+}
 export interface PagePackage {
     ref_id?: string | number;
     /**
@@ -118,6 +126,14 @@ export interface PagePackage {
     name?: string | null;
     price?: number | string | null;
     price_retail?: number | string | null;
+    /**
+     * The package's price in each currency the Campaigns App prices it in,
+     * read from the Campaigns API (`GET /campaigns/?currency=<code>`). `price`
+     * and `price_retail` above stay the default currency's. Optional; a row
+     * that carries it should list every currency the campaign sells in
+     * (PackageCurrencyPrices).
+     */
+    prices?: PackageCurrencyPrice[] | null;
     product_name?: string | null;
     product_sku?: string | null;
     product_variant_name?: string | null;

package/compatibility.json

@@ -1,6 +1,6 @@
 {
   "package": "@nextcommerce/campaigns-os",
-  "version": "1.62.0",
+  "version": "1.66.0",
   "status": "developer-preview",
   "contracts": {
     "campaign_spec": "4.2-5.0",

package/contracts/effects.v1.json

@@ -1,7 +1,7 @@
 {
   "schema": "campaigns-os-effects/v1",
   "_note": "The declared effect of every supported invocation: what it writes, what it sends, and the test case that proves it. One row per command, per subcommand and per effect-changing flag (vocabulary.effect_changing_flags). A row is not publishable without its effect test — scripts/check-effects.mjs refuses one, and refuses a flag from that list that a help usage line carries and no row declares. Read this with docs/effects.md.",
-  "contract_version": "1.3.0",
+  "contract_version": "1.5.0",
   "vocabulary": {
     "annotations": {
       "readOnlyHint": "The invocation changes nothing: no file under the target, the working directory or the user's machine, and no request off the machine. The command-lifecycle journal counts — a journal append is a write like any other, so every readOnlyHint: true row is an invocation the CLI exempts from lifecycle capture (the converse does not hold: some journal-exempt invocations, such as demo and the --no-write forms, still write other declared files).",
@@ -356,6 +356,67 @@
       "test_scope": "full",
       "notes": "page-kit sync --dry-run runs every check the real invocation runs and prints what it would do; it writes nothing under the target, appends no lifecycle entry (the command is declared `dryRun` in src/invocation.mjs) and runs no stale-session closeout."
     },
+    {
+      "command": "spec",
+      "subcommand": "fetch",
+      "flags": [],
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "openWorldHint": true,
+        "idempotentHint": true
+      },
+      "tier": "A",
+      "writes": [
+        {
+          "path": "{target}/.campaign-runtime/fetched-specs/*.json",
+          "when": "the packet's saved-Map copy is not on this checkout; a copy already there is never replaced and nothing is sent",
+          "observed_in": [
+            "no_session",
+            "ambient_session",
+            "stale_session",
+            "lifecycle_log",
+            "persisted_consent"
+          ]
+        },
+        {
+          "path": "{target}/.gitignore",
+          "when": "the command succeeds and the managed block is missing, lacks an entry the toolkit requires, or still lists fetched-specs/",
+          "observed_in": [
+            "no_session",
+            "stale_session",
+            "lifecycle_log",
+            "persisted_consent"
+          ]
+        },
+        {
+          "path": "{lifecycle-journal}",
+          "when": "a lifecycle journal is selected for the invocation — an active run session, --lifecycle-journal, or CAMPAIGNS_OS_LIFECYCLE_LOG",
+          "observed_in": [
+            "ambient_session",
+            "lifecycle_log"
+          ]
+        }
+      ],
+      "sends": [
+        {
+          "destination": "{proxy-base}/api/spec/{map-id}",
+          "what": "the CampaignSpec fetch",
+          "when": "the packet's saved-Map copy is not on this checkout",
+          "requires_consent": false,
+          "observed_in": [
+            "no_session",
+            "ambient_session",
+            "stale_session",
+            "lifecycle_log",
+            "persisted_consent"
+          ]
+        }
+      ],
+      "effect_test": "effects: spec fetch",
+      "test_scope": "full",
+      "notes": "Fills a gap only: the copy on disk can hold spec derive edits the Map does not. The packet and the records are not written; a Map that has moved since they were made is reported as bound: differs."
+    },
     {
       "command": "spec",
       "subcommand": "derive",
@@ -6214,6 +6275,73 @@
       "test_scope": "full",
       "notes": "record brief --dry-run runs every check the real invocation runs and prints the outcome and the files it would write; it writes nothing (no packet, brief, Build Context, report or stale stamp), takes no target lock, appends no lifecycle entry (the command is declared `dryRun` in src/invocation.mjs) and runs no stale-session closeout."
     },
+    {
+      "command": "record",
+      "subcommand": "baseline",
+      "flags": [],
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": true,
+        "openWorldHint": false,
+        "idempotentHint": false
+      },
+      "tier": "C",
+      "writes": [
+        {
+          "path": "{runtime}/assembly-report.json",
+          "when": "the record passes every check — stages.polish and stages.qa become baseline_accepted with what they held moved to history, and commerce_baseline names who accepted which build",
+          "observed_in": [
+            "no_session",
+            "ambient_session",
+            "stale_session",
+            "lifecycle_log",
+            "persisted_consent"
+          ]
+        },
+        {
+          "path": "{runtime}/doctor-output.json",
+          "when": "a retained doctor sidecar exists — the record postdates the doctor snapshot, so it is stamped stale",
+          "observed_in": [
+            "no_session",
+            "ambient_session",
+            "stale_session",
+            "lifecycle_log",
+            "persisted_consent"
+          ]
+        },
+        {
+          "path": "{lifecycle-journal}",
+          "when": "a lifecycle journal is selected for the invocation — an active run session, --lifecycle-journal, or CAMPAIGNS_OS_LIFECYCLE_LOG",
+          "observed_in": [
+            "ambient_session",
+            "lifecycle_log"
+          ]
+        }
+      ],
+      "sends": [],
+      "effect_test": "effects: record baseline",
+      "test_scope": "full",
+      "notes": "One time per funnel, for a handed-off funnel whose records predate markup hashes. Tests nothing and sends nothing. It replaces the live Polish and QA records, so any purchase proof they held stops counting; history keeps them."
+    },
+    {
+      "command": "record",
+      "subcommand": "baseline",
+      "flags": [
+        "--dry-run"
+      ],
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "openWorldHint": false,
+        "idempotentHint": true
+      },
+      "tier": "none",
+      "writes": [],
+      "sends": [],
+      "effect_test": "effects: record baseline --dry-run",
+      "test_scope": "full",
+      "notes": "record baseline --dry-run runs every check the real invocation runs and prints the files it would write; it writes nothing, takes no target lock, appends no lifecycle entry (the command is declared `dryRun` in src/invocation.mjs) and runs no stale-session closeout."
+    },
     {
       "command": "record",
       "subcommand": "spec",

package/contracts/fixtures/runtime-recipe/accept/current.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/accept/minimal.json

@@ -126,6 +126,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/dist-states.json

@@ -2,7 +2,7 @@
   "_note": "Declarative descriptions of the prepared-runtime states an output-check implementation must distinguish. A test builds each state from the accepted recipe rather than from paths written down here, so adding a module to the input set cannot leave a fixture describing an inventory that no longer exists.",
   "schema": "campaigns-os-runtime-recipe-dist-states/v1",
   "directory": "campaign-spec/dist",
-  "expected_file_count": 92,
+  "expected_file_count": 94,
   "states": [
     {
       "id": "healthy",

package/contracts/fixtures/runtime-recipe/reject/advisory-enforcement.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/allowlist-without-hosts.json

@@ -129,6 +129,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/committed-output-claim.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/engines-disagreement-warns.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/lifecycle-scripts-enabled.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unknown-kind.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unknown-network-policy.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unknown-output-check.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unknown-revision.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unknown-step-id.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unperformable-check-skipped.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",

package/contracts/fixtures/runtime-recipe/reject/unpinned-lockfile.json

@@ -131,6 +131,7 @@
       "campaign-spec/rules/index.ts",
       "campaign-spec/rules/offer-ref-integrity.ts",
       "campaign-spec/rules/one-checkout-per-path.ts",
+      "campaign-spec/rules/package-currency-prices.ts",
       "campaign-spec/rules/package-pricing-sanity.ts",
       "campaign-spec/rules/page-count.ts",
       "campaign-spec/rules/page-id-uniqueness.ts",