@nextcommerce/campaigns-os 1.62.0 → 1.63.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 Notable supported-surface changes are recorded here.
 
+## [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[];
     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.63.0",
   "status": "developer-preview",
   "contracts": {
     "campaign_spec": "4.2-5.0",

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",

package/contracts/release-ledger.json

@@ -10418,6 +10418,267 @@
         }
       ],
       "entry_sha256": "34151f9822332d3b3e122b637a8d49095fcfd192529bffb26fa923016d1367d5"
+    },
+    {
+      "id": "RL-0313",
+      "sequence": 301,
+      "date": "2026-10-31",
+      "kind": "release",
+      "surface_version": "1.63.0",
+      "changelog_section": "1.63.0",
+      "changelog_sha256": "709a63c33ef9f64e9fceb7e52e7ba1a7b35e2e8fb4404bb56aa0eac8c0702707",
+      "agent_impact": "A page package row may carry prices[] ({ currency, price, price_retail?, price_recurring? } per currency, read from GET /campaigns/?currency=<code>); price and price_retail stay the default currency's. CampaignSpec validation adds PackageCurrencyPrices, a warning for a row whose prices[] lacks a currency the campaign sells in, has a malformed entry, or lists a currency twice. A row without prices[] is unchanged and unchecked. Refresh skills to 1.63.0+skills.1 (a revision restamp; the skill text is otherwise unchanged).",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/rules/campaign-currencies.ts",
+          "surface_entry": null,
+          "summary": "Exports isCurrencyCode for the package price rule."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/rules/index.ts",
+          "surface_entry": null,
+          "summary": "Registers PackageCurrencyPrices in the rule sets."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/rules/package-currency-prices.ts",
+          "surface_entry": null,
+          "summary": "New PackageCurrencyPrices rule: a page package row with prices[] has a well-formed entry for every currency the campaign sells in (warning)."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/types.ts",
+          "surface_entry": null,
+          "summary": "PagePackage gains prices; new PackageCurrencyPrice type."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "compatibility.json",
+          "surface_entry": null,
+          "summary": "Version advances to 1.63.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/accept/current.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/accept/current.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/accept/minimal.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/accept/minimal.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/dist-states.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/dist-states.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/advisory-enforcement.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/advisory-enforcement.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/allowlist-without-hosts.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/allowlist-without-hosts.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/committed-output-claim.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/committed-output-claim.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/engines-disagreement-warns.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/engines-disagreement-warns.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/lifecycle-scripts-enabled.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/lifecycle-scripts-enabled.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unknown-kind.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unknown-kind.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unknown-network-policy.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unknown-network-policy.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unknown-output-check.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unknown-output-check.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unknown-revision.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unknown-revision.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unknown-step-id.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unknown-step-id.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unperformable-check-skipped.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unperformable-check-skipped.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "contracts/fixtures/runtime-recipe/reject/unpinned-lockfile.json",
+          "surface_entry": "contracts/fixtures/runtime-recipe/reject/unpinned-lockfile.json",
+          "summary": "Regenerated with the new recipe input."
+        },
+        {
+          "class": "hashed_surface",
+          "path": "contracts/runtime-recipe.campaigns-os-node-v1.json",
+          "surface_entry": "contracts/runtime-recipe.campaigns-os-node-v1.json",
+          "summary": "Inputs gain campaign-spec/rules/package-currency-prices.ts."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/supported-surface.json",
+          "surface_entry": "contracts/supported-surface.json",
+          "summary": "surface_version 1.63.0 and refreshed hashes for both CampaignSpec schemas and the runtime recipe."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/local-setup.md",
+          "surface_entry": "docs/local-setup.md",
+          "summary": "Install pins @nextcommerce/campaigns-os@1.63.0."
+        },
+        {
+          "class": "documentation",
+          "path": "docs/orientation-contract-reference.md",
+          "surface_entry": "docs/orientation-contract-reference.md",
+          "summary": "Regenerated at supported surface 1.63.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/runtime-readiness.md",
+          "surface_entry": "docs/runtime-readiness.md",
+          "summary": "Regenerated at supported surface 1.63.0 with the new recipe input."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Examples name bundle revision 1.63.0+skills.1."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "package-lock.json",
+          "surface_entry": null,
+          "summary": "Version advances to 1.63.0."
+        },
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Version advances to 1.63.0."
+        },
+        {
+          "class": "schema",
+          "path": "schemas/campaign-spec.v4.schema.json",
+          "surface_entry": "schemas/campaign-spec.v4.schema.json",
+          "summary": "pagePackage.prices: an optional per-currency price list."
+        },
+        {
+          "class": "schema",
+          "path": "schemas/campaign-spec.v5.schema.json",
+          "surface_entry": "schemas/campaign-spec.v5.schema.json",
+          "summary": "pagePackage.prices: an optional per-currency price list."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance bundle revision to 1.63.0+skills.1 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-sdk-bump/SKILL.md",
+          "surface_entry": null,
+          "summary": "Carry the advanced bundle revision and matching per-skill version."
+        }
+      ],
+      "entry_sha256": "a5fe5aad03d3bf64be6fd7af32b8038867982fad1ee0c8a91a733eccdb46106b"
     }
   ]
 }

package/contracts/runtime-recipe.campaigns-os-node-v1.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/supported-surface.json

@@ -1,6 +1,6 @@
 {
   "_note": "The downstream contract manifest. Everything listed here is SUPPORTED SURFACE: consumers (campaigns-agent, campaign-builder, the private ops repo, page-kit campaign repos) may depend on it, and changing it is a deliberate act — hashed entries require a surface_version bump in the same change (check-supported-surface.mjs --base, mirroring the skills.json bump gate), named entries must keep existing at their path, cli_commands must keep resolving in the CLI dispatch, package_exports must stay exported, and every entry must ship in the npm pack (files[] coverage). Anything NOT listed here — src/** internals, scripts/** checkers, examples/**, prompts/**, contracts/** other than this file and the entries named[] below (the orientation contract, the release ledger, and the consumer-facing orientation fixtures) — is implementation: consumers may read it for context but must not build on it, and it can change without notice. Rationale and the compatibility promise: docs/supported-surface.md.",
-  "surface_version": "1.62.0",
+  "surface_version": "1.63.0",
   "package_exports": [
     "./commercial-journey",
     "./commercial-parity",
@@ -52,7 +52,7 @@
       "sha256": "53269453dfdaac4b286124d445b60b0c46205dfbaf8037ac61b30254a32df53a"
     },
     "contracts/runtime-recipe.campaigns-os-node-v1.json": {
-      "sha256": "3a960f347a8b7de7d9f223fb2bc1ae35091c943d480bca931bf8afa5e70fa83f"
+      "sha256": "4755be6c700463e99b609ceaebeb92cb1df5c54805aeaea3e6fd68e87ebcd6ef"
     },
     "schemas/campaign-build-brief.v1.schema.json": {
       "sha256": "d524003184131398dc15fdb84385af1be0de0c69d6c5ede7278689a5b6101b81"
@@ -70,10 +70,10 @@
       "sha256": "1e309c5dad8c5eeef26ef6fd3b6b90b72440c5104319a161002b17f1359fbd76"
     },
     "schemas/campaign-spec.v4.schema.json": {
-      "sha256": "587df2fdd5707b515a9b8685d30070bcf4bdac9e15de7a94df82224ef4fd91b6"
+      "sha256": "4e9a092c1426429b727aaa6ef5622ae2c6c6dad59270f08636987847b63f5001"
     },
     "schemas/campaign-spec.v5.schema.json": {
-      "sha256": "c606453dc57d210a5a5ed8a099bf868546ae8f5996cf9ba0f8e71a50b2b03fa4"
+      "sha256": "24d04c8d3ede920de161fadf914dc497a3f61e126f377cb01dd0aeff12b53c4f"
     },
     "schemas/campaigns-os-legacy-migration-inventory.v0.schema.json": {
       "sha256": "d6edc4572900d15fdaf6b8c59916b0d885303c1d398bdadeb7c58285522c9049"

package/docs/campaignspec-authoring-examples.md

@@ -116,6 +116,36 @@ Generator checklist:
 These checks are the `CampaignCurrencies` validator rule, which
 `campaigns-os doctor` runs with the rest of the spec rules.
 
+A page package row can also carry its price in each currency, as `prices[]`:
+
+```json
+{
+  "ref_id": 101, "qty": 1, "price": "49.99", "price_retail": "79.99",
+  "prices": [
+    { "currency": "USD", "price": "49.99", "price_retail": "79.99" },
+    { "currency": "EUR", "price": "46.99", "price_retail": "74.99" }
+  ]
+}
+```
+
+- `price` and `price_retail` stay the default currency's. Each `prices[]`
+  entry has a `currency` code and a `price`, plus `price_retail` and, for a
+  subscription package, `price_recurring` when the Campaigns App has them.
+- The values come from the Campaigns API read in each currency
+  (`GET /campaigns/?currency=EUR`). That read returns only the packages the
+  Campaigns App has a price for in that currency, so a package with no EUR
+  price is missing from the campaign for a shopper paying in EUR. Map Builder
+  fills `prices[]` when it refreshes from the API; set prices in the
+  Campaigns App, not in the spec. `campaigns-os spec derive` refreshes `price`
+  and `price_retail` from one default-currency read and leaves `prices[]` as
+  it was, so after changing a non-default price, refresh the Map in Map
+  Builder.
+- `prices[]` is optional. A row without it says nothing about other
+  currencies and is not checked. A row with it should list every currency in
+  `available_currencies` and `campaign.currency`; the `PackageCurrencyPrices`
+  rule warns on a missing currency, a malformed entry and a currency listed
+  twice.
+
 ## Order Bump Notes
 
 An order bump is still a checkout package/offer surface. It should be encoded as

package/docs/local-setup.md

@@ -3,7 +3,7 @@
 For a new campaign, create an empty working folder and run this from it:
 
 ```sh
-npm init -y && npm install --save-exact next-campaign-page-kit@0.3.0 && npm install --save-dev --save-exact @nextcommerce/campaigns-os@1.62.0 && npx --no-install campaigns-os tooling setup --target . --platform claude
+npm init -y && npm install --save-exact next-campaign-page-kit@0.3.0 && npm install --save-dev --save-exact @nextcommerce/campaigns-os@1.63.0 && npx --no-install campaigns-os tooling setup --target . --platform claude
 ```
 
 `npm init -y` gives the folder its own `package.json`. Without one, npm

package/docs/orientation-contract-reference.md

@@ -26,7 +26,7 @@ Ledger schema id: `campaigns-os-release-ledger/v1`
 Change policy version: `1.0.0`  
 Reason-code vocabulary version: `1.0.0`  
 Limits version: `1.0.0`  
-Supported surface at generation time: `1.62.0`
+Supported surface at generation time: `1.63.0`
 
 ## Forward compatibility
 

package/docs/runtime-readiness.md

@@ -8,7 +8,7 @@
 
 How a checkout of this repository at one commit becomes a usable installed runtime, and how a consumer decides whether a prepared one is still trustworthy. Everything below is generated from `contracts/runtime-recipe.campaigns-os-node-v1.json`, which is the only authority for these values.
 
-Recipe kind `campaigns-os-node-v1`, revision `1.0.3`, validated by `schemas/campaigns-os-runtime-recipe.v1.schema.json` (`Campaigns OS Runtime Recipe v1`). Supported surface at generation time: `1.62.0`.
+Recipe kind `campaigns-os-node-v1`, revision `1.0.3`, validated by `schemas/campaigns-os-runtime-recipe.v1.schema.json` (`Campaigns OS Runtime Recipe v1`). Supported surface at generation time: `1.63.0`.
 
 ## What this is
 
@@ -81,7 +81,7 @@ Not redundant with the install step. Because install runs with lifecycle scripts
 
 The complete input set, enumerated explicitly rather than globbed. The compiler's configured include globs are NOT the input set: two root modules enter the compilation transitively through imports from the entry module and are emitted, so a fingerprint derived from the globs would cover 36 of the 38 compiled sources and miss one of the larger emitted surfaces. Test fixtures and the package's own tests are not inputs; nothing under them is emitted. A checker resolves the compiler's actual file list and asserts it equals this enumeration, so this list cannot rot silently.
 
-Fingerprint algorithm `sha256`, over 50 enumerated files:
+Fingerprint algorithm `sha256`, over 51 enumerated files:
 
 - `campaign-spec/analytics-vendors.ts`
 - `campaign-spec/analytics-vocabulary.ts`
@@ -109,6 +109,7 @@ Fingerprint algorithm `sha256`, over 50 enumerated files:
 - `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`
@@ -140,7 +141,7 @@ The output directory is a build product. It is untracked and git-ignored, no com
 
 Directory `campaign-spec/dist`. Committed: `false`. Type entry `campaign-spec/dist/index.d.ts`.
 
-Expected inventory is derived, never listed twice. For every enumerated input under module_source_root whose path ends in .ts, the build is expected to emit campaign-spec/dist/<path relative to module_source_root, with .ts replaced> once per entry in emitted_extensions. The expected inventory is exactly that set: nothing missing, nothing extra. Emitted extensions: `.js`, `.d.ts`. At this revision that derivation yields 92 files.
+Expected inventory is derived, never listed twice. For every enumerated input under module_source_root whose path ends in .ts, the build is expected to emit campaign-spec/dist/<path relative to module_source_root, with .ts replaced> once per entry in emitted_extensions. The expected inventory is exactly that set: nothing missing, nothing extra. Emitted extensions: `.js`, `.d.ts`. At this revision that derivation yields 94 files.
 
 ### Mandatory checks
 

package/docs/skills-revision.md

@@ -16,7 +16,7 @@ that the copy on disk moved.
 `skills.json` carries one top-level field:
 
 ```json
-"bundle_revision": "1.62.0+skills.1"
+"bundle_revision": "1.63.0+skills.1"
 ```
 
 The spelling is `<package version>+skills.<n>`:
@@ -25,7 +25,7 @@ The spelling is `<package version>+skills.<n>`:
   skills ship with (`check-skill-versions.mjs` fails if the two disagree);
 - `<n>` is a plain counter, not a semver component. It says "this is the *n*th
   skill-text revision published against that package version" and it **resets
-  with the prefix**. `1.62.0+skills.1` is therefore ahead of `1.40.0+skills.7`.
+  with the prefix**. `1.63.0+skills.1` is therefore ahead of `1.40.0+skills.7`.
 
 It is one identity for the bundle as a whole, on purpose. Per-skill versions
 still exist and still gate per-skill changes, but an agent that loaded one skill
@@ -37,7 +37,7 @@ The first body line of every bundled `SKILL.md`, immediately after the
 frontmatter, is exactly:
 
 ```
-Bundle revision: 1.62.0+skills.1
+Bundle revision: 1.63.0+skills.1
 ```
 
 followed by a short paragraph telling the agent to run the check below at the
@@ -48,7 +48,7 @@ text the agent is actually reading, not from a file it would have to go and open
 ## The check
 
 ```bash
-npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1
+npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1
 ```
 
 The value is compared against the bundle revision of the **CLI the command runs
@@ -90,20 +90,20 @@ reports the choice as `skills.scope` (`requested`, `installed_platforms`, or
 "revision_check": "match",
 "skills_revision": {
   "status": "match",
-  "requested": "1.62.0+skills.1",
+  "requested": "1.63.0+skills.1",
   "spelling": "bundle",
-  "on_disk": "1.62.0+skills.1",
+  "on_disk": "1.63.0+skills.1",
   "on_disk_skill": null,
-  "message": "match (1.62.0+skills.1)"
+  "message": "match (1.63.0+skills.1)"
 }
 ```
 
 The text view prints one named line, as a header above the rest of the status:
 
 ```
-Skills revision: match (1.62.0+skills.1)
-Skills revision: mismatch: loaded 1.39.0+skills.1, on disk 1.62.0+skills.1 — start a fresh session
-Skills revision: unchecked (on disk 1.62.0+skills.1)
+Skills revision: match (1.63.0+skills.1)
+Skills revision: mismatch: loaded 1.39.0+skills.1, on disk 1.63.0+skills.1 — start a fresh session
+Skills revision: unchecked (on disk 1.63.0+skills.1)
 ```
 
 `unchecked` is the state when the flag is absent. It is not an error — an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextcommerce/campaigns-os",
-  "version": "1.62.0",
+  "version": "1.63.0",
   "description": "Toolkit for agent-assisted NEXT campaign builds.",
   "license": "Apache-2.0",
   "repository": {

package/schemas/campaign-spec.v4.schema.json

@@ -254,6 +254,21 @@
         "name": { "type": ["string", "null"] },
         "price": { "type": ["string", "number", "null"] },
         "price_retail": { "type": ["string", "number", "null"] },
+        "prices": {
+          "type": ["array", "null"],
+          "description": "The package's price in each currency the Campaigns App prices it in, one entry per currency, read from the Campaigns API (GET /campaigns/?currency=<code>), which returns only the packages priced in the requested currency. price and price_retail stay the default currency's. Optional: a row without prices (absent or null) says nothing about other currencies. A row with prices should list every currency in campaign.available_currencies and campaign.currency; the PackageCurrencyPrices rule warns when one is missing, since the campaign leaves the package out in that currency.",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["currency", "price"],
+            "properties": {
+              "currency": { "type": "string", "description": "Three-letter upper-case ISO 4217 code." },
+              "price": { "type": ["string", "number"] },
+              "price_retail": { "type": ["string", "number", "null"] },
+              "price_recurring": { "type": ["string", "number", "null"] }
+            }
+          }
+        },
         "product_name": { "type": ["string", "null"] },
         "product_sku": { "type": ["string", "null"] },
         "product_variant_name": { "type": ["string", "null"] },

package/schemas/campaign-spec.v5.schema.json

@@ -254,6 +254,21 @@
         "name": { "type": ["string", "null"] },
         "price": { "type": ["string", "number", "null"] },
         "price_retail": { "type": ["string", "number", "null"] },
+        "prices": {
+          "type": ["array", "null"],
+          "description": "The package's price in each currency the Campaigns App prices it in, one entry per currency, read from the Campaigns API (GET /campaigns/?currency=<code>), which returns only the packages priced in the requested currency. price and price_retail stay the default currency's. Optional: a row without prices (absent or null) says nothing about other currencies. A row with prices should list every currency in campaign.available_currencies and campaign.currency; the PackageCurrencyPrices rule warns when one is missing, since the campaign leaves the package out in that currency.",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["currency", "price"],
+            "properties": {
+              "currency": { "type": "string", "description": "Three-letter upper-case ISO 4217 code." },
+              "price": { "type": ["string", "number"] },
+              "price_retail": { "type": ["string", "number", "null"] },
+              "price_recurring": { "type": ["string", "number", "null"] }
+            }
+          }
+        },
         "product_name": { "type": ["string", "null"] },
         "product_sku": { "type": ["string", "null"] },
         "product_variant_name": { "type": ["string", "null"] },

package/skills/campaign-lifecycle-orientation/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: campaign-lifecycle-orientation
-version: 1.0.48
+version: 1.0.49
 description: Orient a reader to the Campaigns OS lifecycle artifacts a run has already emitted, without advancing any stage or changing any state.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/campaign-readback-classification/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: campaign-readback-classification
-version: 1.0.48
+version: 1.0.49
 description: Classify a selected campaign from the readback projection's v2 fields and write a read-only handoff without turning diagnosis into permission.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/campaign-run-evidence/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: campaign-run-evidence
-version: 1.0.48
+version: 1.0.49
 description: Interpret existing Campaigns OS doctor, QA and proof-depth evidence without claiming more proof than the artifacts contain.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/contribution-intake/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: contribution-intake
-version: 1.0.48
+version: 1.0.49
 description: Turn a suggestion about the agent surface into a classified, evidence-checked proposal and, only with attended approval, one issue on this repository's tracker.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/next-campaigns-build/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: next-campaigns-build
-version: 1.0.53
+version: 1.0.54
 description: Assemble a NEXT campaign from a doctor-cleared Build Packet, CampaignSpec/API values, prepared HTML/assets, page-kit, and starter-template contracts.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/next-campaigns-os/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: next-campaigns-os
-version: 1.0.68
+version: 1.0.69
 description: Coordinate Campaigns OS lifecycle workflows from CampaignSpec, Build Packet, starter-template contracts, stage reports, deploy evidence, and QA proof depth.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/next-campaigns-os-setup/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: next-campaigns-os-setup
-version: 2.0.51
+version: 2.0.52
 description: Bootstrap or prepare a target page-kit campaign repo from a doctor-cleared Campaigns OS Build Packet before full build wiring. Formerly installed as next-campaigns-setup; renamed 2026-08 to stop colliding with the published NextCommerceCo/skills scaffolder of that name.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/next-campaigns-polish/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: next-campaigns-polish
-version: 1.1.53
+version: 1.1.54
 description: Run the visual/runtime polish pass after build and before QA for a Campaigns OS campaign.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/next-campaigns-qa/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: next-campaigns-qa
-version: 1.3.52
+version: 1.3.53
 description: Run spec-aware QA from a saved Map or local-spec Build Packet and tested campaign URL after build, polish, and deploy/local evidence exist, including Playwright typed-card test-order proof.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills/next-campaigns-sdk-bump/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: next-campaigns-sdk-bump
-version: 1.0.8
+version: 1.0.9
 description: Bump a live campaign's Campaign Cart SDK from one 0.4.x release to a later 0.4.x on a page-kit or static repo. Use for any request to bump, upgrade or move a campaign to SDK 0.4.x, including when the repository has its own BUMP.md. Find every pin, check the release diff and storage against the campaign's own code, prove on a preview with approved test orders, and report what is not proven.
 ---
 
-Bundle revision: 1.62.0+skills.1
-Run `npx --no-install campaigns-os tooling status --skills-revision 1.62.0+skills.1`
+Bundle revision: 1.63.0+skills.1
+Run `npx --no-install campaigns-os tooling status --skills-revision 1.63.0+skills.1`
 from the campaign's Page Kit folder, where it runs the project's pinned copy and
 never installs one, at the start of each task. Start a fresh session if it
 reports `mismatch`: this text is already in your context and is never re-read

package/skills.json

@@ -1,7 +1,7 @@
 {
   "name": "campaigns-os-skills",
   "description": "Skills bundled with Campaigns OS. `skills.sh` installs these into the shared agent skill directories (~/.claude/skills, ~/.codex/skills), so each one is a versioned package: bump the version whenever a package changes. `bundle_revision` identifies the bundle as a whole — `<package version>+skills.<n>`, where the prefix is this package's version and `<n>` counts the skill-text revisions published against it. It advances whenever ANY bundled skill changes, every SKILL.md states it on its first body line, and `campaigns-os tooling status --skills-revision <value>` compares the value an agent read from a skill against the bundle on disk. See docs/skills-revision.md.",
-  "bundle_revision": "1.62.0+skills.1",
+  "bundle_revision": "1.63.0+skills.1",
   "homepage": "https://github.com/NextCommerceCo/campaigns-os",
   "retired_skills": [
     {
@@ -16,7 +16,7 @@
     {
       "id": "next-campaigns-os",
       "name": "Campaigns OS Lifecycle",
-      "version": "1.0.68",
+      "version": "1.0.69",
       "path": "skills/next-campaigns-os/SKILL.md",
       "domain": "campaigns",
       "description": "Coordinate Campaigns OS lifecycle workflows from CampaignSpec, Build Packet, starter-template contracts, stage reports, deploy evidence, and QA proof depth."
@@ -24,7 +24,7 @@
     {
       "id": "next-campaigns-os-setup",
       "name": "Campaigns OS Setup",
-      "version": "2.0.51",
+      "version": "2.0.52",
       "path": "skills/next-campaigns-os-setup/SKILL.md",
       "domain": "campaigns",
       "description": "Bootstrap or prepare a target page-kit campaign repo from a doctor-cleared Campaigns OS Build Packet before full build wiring. Formerly next-campaigns-setup; renamed to release that name to the published NextCommerceCo/skills scaffolder."
@@ -32,7 +32,7 @@
     {
       "id": "next-campaigns-build",
       "name": "Campaign Build",
-      "version": "1.0.53",
+      "version": "1.0.54",
       "path": "skills/next-campaigns-build/SKILL.md",
       "domain": "campaigns",
       "description": "Assemble a NEXT campaign from a doctor-cleared Build Packet, CampaignSpec/API values, prepared HTML/assets, page-kit, and starter-template contracts."
@@ -40,7 +40,7 @@
     {
       "id": "next-campaigns-polish",
       "name": "Campaign Polish",
-      "version": "1.1.53",
+      "version": "1.1.54",
       "path": "skills/next-campaigns-polish/SKILL.md",
       "domain": "campaigns",
       "description": "Run the visual/runtime polish pass after build and before QA for a Campaigns OS campaign."
@@ -48,7 +48,7 @@
     {
       "id": "next-campaigns-qa",
       "name": "Campaign QA",
-      "version": "1.3.52",
+      "version": "1.3.53",
       "path": "skills/next-campaigns-qa/SKILL.md",
       "domain": "campaigns",
       "description": "Run spec-aware QA from a saved Map or local-spec Build Packet and tested campaign URL after build, polish, and deploy/local evidence exist, including Playwright typed-card test-order proof."
@@ -56,7 +56,7 @@
     {
       "id": "campaign-lifecycle-orientation",
       "name": "Campaign Lifecycle Orientation",
-      "version": "1.0.48",
+      "version": "1.0.49",
       "path": "skills/campaign-lifecycle-orientation/SKILL.md",
       "domain": "campaigns",
       "description": "Orient a reader to the Campaigns OS lifecycle artifacts a run has already emitted, without advancing their state: the shared vocabulary, doctor as a gate, the stage record, and the store-theme/Page Kit two-worlds trap."
@@ -64,7 +64,7 @@
     {
       "id": "campaign-run-evidence",
       "name": "Campaign Run Evidence",
-      "version": "1.0.48",
+      "version": "1.0.49",
       "path": "skills/campaign-run-evidence/SKILL.md",
       "domain": "campaigns",
       "description": "Interpret existing doctor, QA verdict and proof-depth evidence without claiming more proof than the artifacts contain, and keep funnel proof apart from merchant launch readiness."
@@ -72,7 +72,7 @@
     {
       "id": "campaign-readback-classification",
       "name": "Campaign Readback Classification",
-      "version": "1.0.48",
+      "version": "1.0.49",
       "path": "skills/campaign-readback-classification/SKILL.md",
       "domain": "campaigns",
       "description": "Classify a selected campaign from the campaigns-os-readback/v2 fields (artifacts, staleness.stale_keys, clean, doctor, divergences, skip_cascades) and write a read-only handoff without turning diagnosis into permission."
@@ -80,7 +80,7 @@
     {
       "id": "contribution-intake",
       "name": "Contribution Intake",
-      "version": "1.0.48",
+      "version": "1.0.49",
       "path": "skills/contribution-intake/SKILL.md",
       "domain": "campaigns",
       "description": "Turn a suggestion about the agent surface into a classified, evidence-checked and redacted proposal, filed on this repository tracker only with attended approval."
@@ -88,7 +88,7 @@
     {
       "id": "next-campaigns-sdk-bump",
       "name": "Campaign SDK Bump",
-      "version": "1.0.8",
+      "version": "1.0.9",
       "path": "skills/next-campaigns-sdk-bump/SKILL.md",
       "domain": "campaigns",
       "description": "Bump a live campaign from one Campaign Cart 0.4.x release to a later 0.4.x on a page-kit or static repo: find every pin, check the release diff and storage against the campaign code, prove on a preview with approved test orders, and report what is not proven."