@nextcommerce/campaigns-os 1.50.0 → 1.53.0

package/contracts/release-ledger.json

@@ -4964,6 +4964,1239 @@
         }
       ],
       "entry_sha256": "3fed96311daa5f153704a1ec7ded952e1e00065ce9f81fd4d3350f13beba964a"
+    },
+    {
+      "id": "RL-0211",
+      "sequence": 203,
+      "date": "2026-10-02",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.2",
+      "changelog_sha256": "883416d360a9f1d0886a232259fbca2931d5c2bec48c528a0584d9441985b69f",
+      "agent_impact": "To fill a local CampaignSpec with package, offer and shipping refs, read the campaign with its public Campaigns API key: one GET of https://campaign-map.nextcommerce.com/api/campaign with the key in X-Campaign-Key, as docs/build-packet.md \"Reading package, offer and shipping refs\" shows. Gateway login does not supply these refs; it only lets spec derive --from-store fill the Store Profile fields. The tooling status warnings for a missing gateway login now say so; they stay warnings and the exit code is unchanged.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Add \"Reading package, offer and shipping refs\" to the local-spec entry: the public-key read of the live campaign, its envelope, and which retrieve-body fields fill campaign.ref_id, page packages, root offers and root shipping methods."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "tooling",
+          "summary": "The tooling status warning for a missing gateway login says login is optional, only fills the Store Profile fields through spec derive --from-store, never reads package, offer or shipping refs, and points to the public-key read."
+        }
+      ],
+      "entry_sha256": "c1848ed1f25ee7a1069dc27e73872741867454a99b3c6d15b88e1408c2074e04"
+    },
+    {
+      "id": "RL-0212",
+      "sequence": 204,
+      "date": "2026-10-02",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.3",
+      "changelog_sha256": "b2a24c76d61c41e2418bb763e25bdc6290e954e786bd2a58a13e615463605229",
+      "agent_impact": "Do not ask the person to approve the source design's own promo, proof or urgency copy: Build Brief question promo_urgency_copy now covers only the starter template's own promo placeholders (demo timers, promo banners, placeholder voucher codes, exit-pop offers) and is asked only when the CampaignSpec maps funnels[].promo_codes, or a checkout page's enabled exit_intent or promo_code_input. To record an answer to any guided question, copy the normalized draft to campaign-build-brief.json in the target repo, set the fields doctor's build_brief.guided_questions warning names, and re-run start or prepare-build; once a stage has recorded evidence that re-run needs --force, which clears it.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/campaign-build-brief.md",
+          "surface_entry": "docs/campaign-build-brief.md",
+          "summary": "Reword question 5 to the template's own promo placeholders and the CampaignSpec surfaces that raise it, and add Answering The Questions with the fields that close each question and the re-run that records them."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "next",
+          "summary": "The QA prompt compares the template's own promo placeholders and trust badges with the brief and says not to flag the source design's own proof, urgency or guarantee elements; the build prompt names the template's promo placeholders instead of promo/urgency language."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "build_brief.guided_questions names the brief fields that close each open question and how to record them (copy the normalized draft to campaign-build-brief.json, set the fields, re-run start or prepare-build; --force clears stage evidence), and build_brief.questions_unanswered names the fields too."
+        }
+      ],
+      "entry_sha256": "0d60b7a2fa569cca0f1db2084e5691be0fac49b23954b92851cc28d337e6b7c5"
+    },
+    {
+      "id": "RL-0213",
+      "sequence": 205,
+      "date": "2026-10-02",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.4",
+      "changelog_sha256": "57bc8faea8b376e689029a495035237c67c2767aaa072578313935a2a4112200",
+      "agent_impact": "At the QA stage of a campaign whose checkout declares an order bump (is_upsell: true rows), run both QA commands next lists: qa_run, then qa_run_bump, the same qa run --browser --test-order common with --cart <base>:1,<bump>:1, whose test orders carry the add-on. A consumer of next --json that keys on action ids should accept qa_run_bump. Progress snapshots record it as qa_run. The bump is read from the checkout QA's test orders run on; when the CampaignSpec does not parse, next warns next.order_bump_spec_unreadable.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "next",
+          "summary": "At the QA stage, when the checkout declares an order bump, next lists qa_run_bump beside qa_run: the same QA command with --cart <first selector tier>:1,<bump>:1. The QA stage prompt and the human next output name it too."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Say that next names the base-plus-bump QA run (qa_run_bump) at the QA stage when the checkout declares an order bump."
+        }
+      ],
+      "entry_sha256": "baedf0070bd55ad5e899b3d697911309bffb4541df7a2c6c1039375ffcf4764d"
+    },
+    {
+      "id": "RL-0214",
+      "sequence": 206,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.5",
+      "changelog_sha256": "ac3f1499849d83b2e4ee2610577a0a996eca1199b2fc1ddd95abe95af8d5e423",
+      "agent_impact": "Before the first test order, unless the operator has already said test orders are fine for this campaign, ask once, up front in your first turn with your other setup questions: test orders land in the store as real orders someone may have to cancel. qa run is unchanged and has no permission flag. An installed agent context keeps the old text until install-agent-context refreshes it; start a fresh session after install-skills, since the bundle revision moved to 1.50.0+skills.2.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "documentation",
+          "path": "agents/claude/CLAUDE.md",
+          "surface_entry": "agents/claude/CLAUDE.md",
+          "summary": "Say qa run has no permission flag and coverage is its only control, that test orders still land in the store as real orders someone may have to cancel, and to ask once, up front in the first turn, unless the operator has already said test orders are fine for the campaign."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/codex/AGENTS.md",
+          "surface_entry": "agents/codex/AGENTS.md",
+          "summary": "Say qa run has no permission flag and coverage is its only control, that test orders still land in the store as real orders someone may have to cancel, and to ask once, up front in the first turn, unless the operator has already said test orders are fine for the campaign."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/copilot/copilot-instructions.md",
+          "surface_entry": "agents/copilot/copilot-instructions.md",
+          "summary": "Say qa run has no permission flag and coverage is its only control, that test orders still land in the store as real orders someone may have to cancel, and to ask once, up front in the first turn, unless the operator has already said test orders are fine for the campaign."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/cursor/campaigns-os.mdc",
+          "surface_entry": "agents/cursor/campaigns-os.mdc",
+          "summary": "Say qa run has no permission flag and coverage is its only control, that test orders still land in the store as real orders someone may have to cancel, and to ask once, up front in the first turn, unless the operator has already said test orders are fine for the campaign."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Use the current 1.50.0+skills.2 bundle in executable examples."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance the bundled skill revision to 1.50.0+skills.2 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Step 11 says qa run has no permission flag, that test orders land in the store as real orders someone may have to cancel, and to ask once, up front in the first turn, unless the operator has already said test orders are fine. Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/references/session-intake.md",
+          "surface_entry": null,
+          "summary": "The test-order proof policy asks once, up front in the first turn, whether test orders are fine for the campaign, unless the operator has already said so, instead of saying they need no permission or approval."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "QA follows an answer the operator already gave on test orders and does not pause to ask again; when nobody asked, it asks once before the first test order. Test orders are no longer called safe to fire any time. Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.50.0+skills.2 bundle revision."
+        }
+      ],
+      "entry_sha256": "b2cabfff7763b6b5782392b81f4586c6198a74a2300b0d69eff4a48de46f9538"
+    },
+    {
+      "id": "RL-0215",
+      "sequence": 207,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.7",
+      "changelog_sha256": "a3ffc2011ba990f3022bcd24248869e717f45c276bae10fb726eb2c09c50e6e7",
+      "agent_impact": "sdk storage-check now resolves Page Kit campaign_asset script srcs and frontmatter scripts to src/<slug>/assets/<path>, so a clean Page Kit campaign whose scope covers its assets reports source-compatible instead of unknown. A resolved script outside --scope is still unknown, named by its real path.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/sdk-storage-compatibility.md",
+          "surface_entry": "docs/sdk-storage-compatibility.md",
+          "summary": "Say that a Page Kit page's campaign_asset script srcs and frontmatter scripts resolve to src/<slug>/assets/<path>, and that any other campaign_asset value reports unknown."
+        }
+      ],
+      "entry_sha256": "067e8f610214c37f9066a53c418a866fb6c5670193af54ebb77dd204b653e92b"
+    },
+    {
+      "id": "RL-0217",
+      "sequence": 208,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.9",
+      "changelog_sha256": "0b678961d04050148587f2994831880d8e93b86da2dc6a010add319f621d6086",
+      "agent_impact": "Record the page-kit build environment with record build --packet <packet> --build-environment development (local proof mode) instead of hand-editing stages.assembly.evidence.build_environment; next names the command under local-serve. A refused record now lists the allowed values for an enum field.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": null,
+          "surface_entry": "record",
+          "summary": "record build takes --build-environment <development|production> and records stages.assembly.evidence.build_environment; a refused record lists a schema enum field's allowed values and the value it got."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "next",
+          "summary": "Under deploy.target local-serve, next names record build --packet <packet> --build-environment development in the build action and prompt, and the page-kit parity messages name it too."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "The local_proof.build_environment warning names record build --build-environment development; an unknown adapter-decision value lists the allowed values."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Document record build --build-environment and that enum refusals list the allowed values."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Local proof mode records the development build with record build --build-environment development."
+        }
+      ],
+      "entry_sha256": "80715cb6b6a421a8929126795d1e38ef88aec3585f15539d162c4908165f06ad"
+    },
+    {
+      "id": "RL-0216",
+      "sequence": 209,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.10",
+      "changelog_sha256": "0f486e2c02fa7cf57cf606277a02d740a0b6d5767d278728462e846a110db3e8",
+      "agent_impact": "A checkout package marked is_order_bump: true is an order bump everywhere the toolkit tells bumps from tiers: the QA tier planner skips it, next names qa_run_bump for it, and commercial-journey plans its with/without scenarios. Specs that mark bumps with is_upsell: true are unchanged; no spec edit is needed.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "next",
+          "summary": "next names qa_run_bump for a checkout bump marked is_order_bump as well as is_upsell, and its description and the QA test-order notes name both flags."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Say that order-bump rows are those marked is_order_bump or is_upsell, for tier planning and for the qa_run_bump command."
+        }
+      ],
+      "entry_sha256": "5646d540954bcbf43556888627b88ba2390e311e8589f093321c3b5350b516b9"
+    },
+    {
+      "id": "RL-0218",
+      "sequence": 210,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.11",
+      "changelog_sha256": "5e70510bf61da0096d4b381caafe2f9e2f6daaffa4895efa073792ded32f1f22",
+      "agent_impact": "When doctor or next warns spec.material_stale, the local CampaignSpec changed materially after prepare-build bound it; QA will refuse the run. Re-run prepare-build from the edited spec before building, polishing or deploying further.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "Doctor warns spec.material_stale when a local-spec campaign's CampaignSpec material hash differs from the Assembly Report's identity.spec_material_hash; next prints it with doctor's other warnings."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Say that doctor and next warn spec.material_stale after a material revision of a local spec."
+        }
+      ],
+      "entry_sha256": "69780cf0debe67051b88def9d99f47ce1e5bcfb947218ed6c7917775c431fbcb"
+    },
+    {
+      "id": "RL-0219",
+      "sequence": 211,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.12",
+      "changelog_sha256": "a69c5a144ba7982e45d0d838f32c9c1d106376527715a9785ec26e054339723d",
+      "agent_impact": "On the local preview (local-serve, loopback), record deploy now accepts the deploy stage next names after record build when polish was never recorded for this build; do not hand-write a polish skip to get past it. Polish stays owed and QA reports it.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Say that on the local preview a polish doctor carries forward does not hold record deploy back, as it does not hold next."
+        }
+      ],
+      "entry_sha256": "ab294f178bf7e40547ec76b7b62434c0879a16c5e01b7a34ddb4842d2a9f7e6c"
+    },
+    {
+      "id": "RL-0220",
+      "sequence": 212,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.13",
+      "changelog_sha256": "00252143f793272579a0b9a9ba1f663f8e2f7aa7b6a1ec3e385d68cc4f81dc64",
+      "agent_impact": "Strip document wrappers in the converted page-kit page (page_kit.output_path); once it exists, doctor checks that page, not the design. Do not copy built pages over the design source or record preserve_document_wrappers for stripped pages to clear source_html.prep.document_wrapper.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "source_html.prep.document_wrapper reads the converted page-kit page at page_kit.output_path once it exists, and reports a converted page that kept its wrappers under that path."
+        }
+      ],
+      "entry_sha256": "54969c14bbde17632be2f5256ab2af74b23c41e78687817f8a43d7b522b12683"
+    },
+    {
+      "id": "RL-0221",
+      "sequence": 213,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.14",
+      "changelog_sha256": "eaaef3e69436b9ad7239018040281e5b37363135c37bccedf34874ad04981cdc",
+      "agent_impact": "Replace the starter icon-grid placeholders Benefit one through Benefit four on built pages before QA: the placeholder-text residue gate now blocks on them, as it does on Lorem, Placeholder, TODO and Product Name.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/next-step.mjs",
+          "surface_entry": "doctor",
+          "summary": "The placeholder-text next-step hint names Benefit one through Benefit four with Lorem, Placeholder, TODO and Product Name."
+        }
+      ],
+      "entry_sha256": "79e0ced726df96635e2d4210266cc691a9c95f8d5aaed12bd13d983093c060f0"
+    },
+    {
+      "id": "RL-0222",
+      "sequence": 214,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.16",
+      "changelog_sha256": "9739f7ffed587ba5d871a04e4eb1a218d94b47d29cefc9c7798abc49877daa5f",
+      "agent_impact": "A failed brand-theme write no longer leaves theme.warnings[].detail null on the Assembly Report, so record setup and record build stop refusing the report for it. Do not hand-edit the report to clear that refusal.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "prepare-build",
+          "summary": "prepare-build and start copy theme write errors onto the Assembly Report theme.warnings with detail only when it is an object, so the report validates against its schema."
+        }
+      ],
+      "entry_sha256": "7d5cff84f46160230a531540cbfcf272bad32e3c36979d570586650924d9331b"
+    },
+    {
+      "id": "RL-0223",
+      "sequence": 215,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.17",
+      "changelog_sha256": "a6f2d75a367e3724e7fb581e172dd5bc85db545fbf636b3675ac72d9a5ba592f",
+      "agent_impact": "Doctor and start now say which CampaignSpec field each of three validation messages wants: campaign.payment_env_key (a Campaigns API key in the spec does not fill it), global_config.sdk_version, and design_source (left off pages built from hand-written or template HTML). Fix the named field rather than treating the key line and the missing-key warning as a contradiction.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/rules/campaign-metadata.ts",
+          "surface_entry": null,
+          "summary": "The missing payment_env_key warning keeps its first sentence and adds that campaign.payment_env_key is empty, where its value comes from, and that a Campaigns API key does not fill it."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/rules/sdk-version.ts",
+          "surface_entry": null,
+          "summary": "The missing SDK version error keeps its first sentence and names global_config.sdk_version in MAJOR.MINOR.PATCH form."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "campaign-spec/rules/design-source-shape.ts",
+          "surface_entry": null,
+          "summary": "The missing design_source.file_url warning says hand-written or template HTML removes design_source from the page, unless design_source.type is figma or ai-generated."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "The no-source-mapping error for a design_source without file_url offers removing design_source for hand-written or template HTML and names the source-html manifest."
+        }
+      ],
+      "entry_sha256": "e9b40ee4e4764bd76dd48a0349e8046bb5e9cff2edb24fd5012566c8fbf05a70"
+    },
+    {
+      "id": "RL-0224",
+      "sequence": 216,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.18",
+      "changelog_sha256": "43b3fda70ba8c201c3c092e248b7ef6eea98813539c6527ca06e12e7643ac7e7",
+      "agent_impact": "QA no longer reports price-claim-mismatch on a page showing a voucher the plan cannot price, and browser-order-bump-state reads a transparent glyph tick as unchecked. Do not rework a voucher-priced upsell or a colour-toggled bump tick to clear either warning.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": null,
+          "summary": "Commercial parity leaves a page's price claims unresolved when the page shows a voucher the normalized plan cannot price."
+        }
+      ],
+      "entry_sha256": "a575bd5b8eb85085f3ba083cc827f1752cb456d3df7584ea2772ef589924e54c"
+    },
+    {
+      "id": "RL-0225",
+      "sequence": 217,
+      "date": "2026-10-03",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.50.0+agent.19",
+      "changelog_sha256": "33836079283beb6ac39aed78ed23f5aa4aa4090f7cc424c9c54dd0846837f0bc",
+      "agent_impact": "A campaign-identity finding on a built file that no CampaignSpec page builds to now names it as leftover output under stray_files. Remove the source file if there is one, delete the built file, and rebuild and record the build again; do not retag the stray page.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "Doctor marks each built page by whether an active CampaignSpec page builds to it before the campaign-identity gate runs."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": null,
+          "summary": "The campaign-identity gate section describes stray_files and the repair for a built file no spec page builds to."
+        }
+      ],
+      "entry_sha256": "6b11a07c55a232f4a461288288807198ba62708b62f07056a4a76e0efc2e75ca"
+    },
+    {
+      "id": "RL-0226",
+      "sequence": 218,
+      "date": "2026-10-04",
+      "kind": "release",
+      "surface_version": "1.51.0",
+      "changelog_section": "1.51.0",
+      "changelog_sha256": "acb40fac6861f258a17cc949e30c2aec372997a69ca4d25df82b133d30c71135",
+      "agent_impact": "Surface 1.51.0. New command checkpoint accept records an operator's accept of a measured QC warning beside the unchanged measurement, and next prints a QC handoff listing open, review, lapsed, unexercised and excluded results with the ref to accept each warning by. Accepts are operator decisions: at the end of QA, run next, present the QC handoff once, and run checkpoint accept only with the refs, reason and name the operator gave you in the conversation, after the warning was shown to them. Never write qc_accepts, qc_results or QA verdict files by hand; the up-front test-order permission does not cover accepts. An accept never changes readiness, a result, the doctor or next status, or the QA disposition, and it lapses when the measured state changes or its evidence is stale or cannot be reproduced. The effects contract declares checkpoint accept (tier B: appends to the Assembly Report, marks the doctor sidecar stale, journals) and its --dry-run form, and declares header-only GETs to the configured store policy URLs on the qa run --browser rows ahead of the check that sends them; QA does not send them yet. Bundled skills carry revision 1.51.0+skills.1: an agent that loaded an earlier revision should start a fresh session. Install the 1.51.0 package with the documented local setup command.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "compatibility_policy",
+          "path": "compatibility.json",
+          "surface_entry": null,
+          "summary": "Advance the declared version to 1.51.0."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/effects.v1.json",
+          "surface_entry": "contracts/effects.v1.json",
+          "summary": "Declare checkpoint accept (tier B: appends to the Assembly Report's qc_accepts and evidence, marks the doctor sidecar stale, journals; sends nothing) and its --dry-run form, and declare header-only GETs to the CampaignSpec's configured store policy URLs on the two qa run --browser rows, ahead of the check that sends them."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/supported-surface.json",
+          "surface_entry": "contracts/supported-surface.json",
+          "summary": "Advance surface_version to 1.51.0 and record the effects contract hash."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/effects.md",
+          "surface_entry": "docs/effects.md",
+          "summary": "Describe what checkpoint accept records, what it never changes, and when an agent may run it."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/local-setup.md",
+          "surface_entry": "docs/local-setup.md",
+          "summary": "Pin the 1.51.0 package in the local setup install command."
+        },
+        {
+          "class": "documentation",
+          "path": "docs/orientation-contract-reference.md",
+          "surface_entry": "docs/orientation-contract-reference.md",
+          "summary": "Regenerate at surface 1.51.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Add the operator-accept section: what checkpoint accept records, what it never changes, and when an agent may run it."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/runtime-readiness.md",
+          "surface_entry": "docs/runtime-readiness.md",
+          "summary": "Regenerate at surface 1.51.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Use the current 1.51.0+skills.1 bundle in executable examples."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "package-lock.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.51.0."
+        },
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.51.0."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance the bundled skill revision to 1.51.0+skills.1 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "At the end of QA, run next and present the QC handoff once, ask the operator which open warnings to accept and why, and run checkpoint accept only with the refs, reason and name the operator gave; never write qc_accepts, qc_results or QA verdict files by hand. Publish the 1.51.0+skills.1 bundle revision."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "checkpoint",
+          "summary": "Add checkpoint accept (refuses unless every listed result is a current accept-eligible warning already on record, and appends only), a QC handoff in next, and qc_results and qc_build_fingerprint on the QA stage evidence; record ingest refuses the package-owned QC keys."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/inspect.mjs",
+          "surface_entry": "doctor",
+          "summary": "Doctor output carries derived.qc_results, empty until a QC check records a result; readiness is unchanged."
+        }
+      ],
+      "entry_sha256": "9702dae850ed7d8c2401f71939cb37eed3b63f09b3b7607f08ad94eccc8338da"
+    },
+    {
+      "id": "RL-0228",
+      "sequence": 219,
+      "date": "2026-10-04",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.51.0+agent.1",
+      "changelog_sha256": "d01e35ae07379f131e9a57ce7651061b0e93644b5f18a4a5cd39aa3b4d7f9478",
+      "agent_impact": "Doctor (the packet path and doctor --built) now runs built_output.cart_placeholders on every built page. A known SDK placeholder such as {item.name}, {subtotal} or {package.name} in live built HTML text, or in an alt, title, placeholder, aria-label or button value attribute outside every SDK-owned scope, is a warning (built_output.cart_placeholders.live_token) that next lists in its QC handoff; unknown brace strings and placeholders on a page whose item template selector is not an #id are review results. Move the placeholder into the SDK-owned <template> or item list that renders it, or remove it, and rebuild. A page passes only when its campaign-cart loader names an exact version in the verified list; otherwise, and on a page over a size, candidate, result or page cap or one that cannot be read, the page reads unexercised, never pass. These results are never blockers and never checkpoint gates, so checkpoint waive does not see them.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Describe the raw cart placeholder check: what it warns on, what is expected, and when a page reads unexercised."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "Doctor runs the raw cart placeholder check after the script syntax gate on the packet path and records its results in derived.qc_results, with warning and review results in warnings[]."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/inspect.mjs",
+          "surface_entry": "doctor",
+          "summary": "doctor --built runs the raw cart placeholder check after the script-syntax check and records its results with the other QC results."
+        }
+      ],
+      "entry_sha256": "925f8d9ad8f524dc8551be91a521d1f29555ce756d2a41c90b95dec16f5bce1f"
+    },
+    {
+      "id": "RL-0231",
+      "sequence": 220,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.51.0+agent.2",
+      "changelog_sha256": "2dbc67b81e660db15be54ec9939a05cab736eed325f84611252272955b525b31",
+      "agent_impact": "After polish capture, the Assembly Report carries media_weight beside page_load from the same capture, and next reads its image weight and oversize results instead of reporting them as not captured by this version. Run polish capture again to replace page_load evidence captured before this change.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "polish",
+          "summary": "polish capture attaches the media_weight record its capture produced beside page_load in the same report write, and refuses one that is not package-produced or not bound to that page_load."
+        }
+      ],
+      "entry_sha256": "6c7e9fea48195b6c141beec753d619710e4d5c91eb6f1c027bcb814e30366bf4"
+    },
+    {
+      "id": "RL-0227",
+      "sequence": 221,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.51.0+agent.3",
+      "changelog_sha256": "c2479b7e88ca58ae09277242c2b9a617e934bd514d3892800f888038924b5b01",
+      "agent_impact": "qa run with a browser test order now seeds synthetic tracking values (utm_*, affid, sub1, subaffiliate2 and up to eight names from analytics.params.tracking.preserve) and reports tracking.url (whether each value survives every observed page navigation through the navigation after the order), tracking.order (whether the matching attribution reached the request of an order the store accepted) and tracking.tag (whether os-tracking-tag literals match order metadata) as QC results in the verdict and the next QC handoff. They are warnings or review results, never blockers. A result passes only when every read it depends on completed: an unobserved step, a reload by QA, an attempt that ended early or a hop the browser did not report as a new-document commit ends the measurement without a pass. Click ids and funnel are not seeded. The persisted verdict never holds a query value: every stored string is cut at its first literal or percent-decoded query.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Describe the tracking parameter results: which values QA seeds, what URL preservation and order attribution report, and what is stored."
+        }
+      ],
+      "entry_sha256": "45f3af2c0db67bb642a1c41f64e01034b031651883ce66cc791ddd38d931ccdb"
+    },
+    {
+      "id": "RL-0229",
+      "sequence": 222,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.51.0+agent.4",
+      "changelog_sha256": "1330ace51c2b5f767c15601d8ec1e75d140ec943f30dafe7d2dd05e21d454152",
+      "agent_impact": "qa run --browser now checks each analytics.params.content entry at runtime: for each applicable page it loads the page in two fresh browser contexts, without the parameter and with ?<name>=n, and reports content_param QC results in the verdict and the next QC handoff. A result passes only when both loads served the requested document and finished the SDK display pass before the 60 s budget ended, every element whose data-next-hide or data-next-show refers to param.<name> is the same stable element in both loads, visible without the parameter and hidden with it, and no reference needs review. A parameter whose handlers cannot hide anything with n is a warning; compound or unreliably parsed conditions, content hidden at baseline, changed targets, failed loads and pairs beyond the eighth or past the budget are review or unexercised results, never blockers. Runs without --browser list the checks as not requested. The verdict stores a hash of each condition, never its text or a query value.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Describe the content parameter results: how QA compares the two loads, what reads as a warning, and what never passes."
+        }
+      ],
+      "entry_sha256": "ceb20731f07feccbedea6abe1376b91c8b830036ee1657fcb0f984c55dfc2b53"
+    },
+    {
+      "id": "RL-0230",
+      "sequence": 223,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": "1.52.0",
+      "changelog_section": "1.52.0",
+      "changelog_sha256": "42e6f8fbe9ed21935c14e69594c5afc6bc6846714b1bd69f88f7e6f556e023fe",
+      "agent_impact": "Surface 1.52.0. qa run --browser now checks each configured store_terms, store_privacy, store_returns, store_shipping and store_contact URL and reports policy.presence and policy.availability QC results in the verdict and the next QC handoff. Presence passes only when QA read the links on every page it visits and one resolves to the configured destination (trailing slash and default port normalized, query kept); a declared footer label that points elsewhere is a warning. Availability passes only when bounded header-only GETs reach a 2xx text/html or application/xhtml+xml page within 5 redirects that differs from the configured URL only in scheme, www. or trailing slash. 404s, server errors and redirects to the store home page are warnings; authentication, rate limits, loops, non-HTML responses, unexpected statuses, non-absolute configured values and redirects elsewhere are review; network failures and anything not finished within the shared 20 s budget or the 15 s per-URL deadline are unexercised. mailto contacts are checked for presence only. Results are never blockers; runs without --browser list them as not requested. Stored destinations carry no query, and a stored record reads back only with exactly the keys QA writes. The effects contract states that qa run --browser sends these header-only GETs to the configured store policy URLs. Bundled skills carry revision 1.52.0+skills.1: an agent that loaded an earlier revision should start a fresh session. Install the 1.52.0 package with the documented local setup command.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "compatibility_policy",
+          "path": "compatibility.json",
+          "surface_entry": null,
+          "summary": "Advance the declared version to 1.52.0."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/effects.v1.json",
+          "surface_entry": "contracts/effects.v1.json",
+          "summary": "State that the two qa run --browser rows send the header-only GETs to the configured store policy URLs, the offline fixture not observing them only because its browser run is blocked at the gate; and state that the offline checkpoint accept fixture is refused (changed_since_handoff) because its synthetic result ref matches no current result, while doctor, Polish and QA checks produce accept-eligible warnings."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/supported-surface.json",
+          "surface_entry": "contracts/supported-surface.json",
+          "summary": "Advance surface_version to 1.52.0 and record the effects contract hash."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/local-setup.md",
+          "surface_entry": "docs/local-setup.md",
+          "summary": "Pin the 1.52.0 package in the local setup install command."
+        },
+        {
+          "class": "documentation",
+          "path": "docs/orientation-contract-reference.md",
+          "surface_entry": "docs/orientation-contract-reference.md",
+          "summary": "Regenerate at surface 1.52.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Describe the policy link results: what presence and availability check, which outcomes are warnings or review results, and what is not requested without --browser."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/runtime-readiness.md",
+          "surface_entry": "docs/runtime-readiness.md",
+          "summary": "Regenerate at surface 1.52.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Use the current 1.52.0+skills.1 bundle in executable examples."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "package-lock.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.52.0."
+        },
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.52.0."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance the bundled skill revision to 1.52.0+skills.1 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.52.0+skills.1 bundle revision."
+        }
+      ],
+      "entry_sha256": "303fbf65d9d538ae55340e7f1606b3acae50453ead24740ddd39149e77082f41"
+    },
+    {
+      "id": "RL-0232",
+      "sequence": 224,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.52.0+agent.1",
+      "changelog_sha256": "8db55e2af8d696493a8c2881667ae538329a101cf5c5c582bc5d0c6e50ca91c9",
+      "agent_impact": "Doctor (the packet path and doctor --built) now runs built_output.smoke_qc on every built page. It warns on an in-page link whose target is missing, a missing favicon or Open Graph title, description or image, an og:image that is not absolute or whose file is missing, the Tailwind CDN script in a production build, references to the cdn.29next.store asset host, and loopback URLs in a production build; next lists these in its QC handoff. Fix the page and rebuild. The Tailwind and loopback rules are decided only for a recorded production build and read unexercised otherwise; a page over a size, candidate, result or page cap, or one that cannot be read, reads unexercised, never pass. These results are never blockers and never checkpoint gates.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Describe the built-output smoke checks: what each rule warns on, which rules need a production build, and when a page reads unexercised."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "Doctor runs the smoke checks after the raw cart placeholder check on the packet path and records their results in derived.qc_results, with warning and review results in warnings[]."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/inspect.mjs",
+          "surface_entry": "doctor",
+          "summary": "doctor --built runs the smoke checks after the raw cart placeholder check, with the build environment and deploy base unknown, and records their results with the other QC results."
+        }
+      ],
+      "entry_sha256": "e9063da2788630cb0017eedc0b2e77b717b290bae0e7cb5d6bcdbbb6e6b7368e"
+    },
+    {
+      "id": "RL-0233",
+      "sequence": 225,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": "1.53.0",
+      "changelog_section": "1.53.0",
+      "changelog_sha256": "b5e6bbfd3ab22a16b715fbd574128715ab5a9a70d76c1e09f8f91c1d25ce72f6",
+      "agent_impact": "Surface 1.53.0. Adds record brief, which saves Campaign Build Brief answers without re-running intake, and record spec, which binds a CampaignSpec change without discarding operator state; their --dry-run forms write nothing and append no lifecycle entry. A brief file is guided unless it sets \"brief_mode\": \"prepared\" (a campaign whose report already records a prepared brief stays prepared). An unchanged or reformatted save keeps every stage's evidence and status. A material brief or CampaignSpec change makes build, Polish and QA owed again (QA alone for a qa_policy change), keeps the last five superseded records per stage as history that is never current proof, and next, doctor, progress, readback and the Assembly Report status report the owed stage; next offers refresh_inputs (record brief or record spec) when a recorded stage was made against earlier content. Build, Polish and QA records now stamp the brief and CampaignSpec content they were made against; records without stamps read unconfirmed. Re-recording an unchanged build after an input change keeps the build owed unless the operator's --deviation-reason records that the change needs no output change; Polish stays owed until a new capture postdates the change. Intake refuses, without --force, to discard recorded waivers, warning accepts, stage history, an applied theme, or a recorded deploy target, preview URL, production URL, order-path depth or allowed-domains confirmation; --force archives the build, Polish and QA records it clears and keeps stage history. spec derive no longer rebinds report identity and its --json result no longer carries rebound; run record spec after it. Bundled skills carry revision 1.53.0+skills.1: an agent that loaded an earlier revision should start a fresh session. Install the 1.53.0 package with the documented local setup command.",
+      "compatibility": "breaking",
+      "migration": "After upgrading, next routes each in-flight campaign back to build once, because build, Polish and QA records made before 1.53.0 do not record which brief and CampaignSpec content they used: re-record build and Polish, and run QA again for a new verdict. Add \"brief_mode\": \"prepared\" to a hand-written brief file whose open questions should block. Save brief answers with record brief and CampaignSpec changes with record spec instead of re-running start, prepare-build or build, which now refuse without --force to discard recorded waivers, warning accepts, stage history, an applied theme, or a recorded deploy target, preview URL, production URL, order-path depth or allowed-domains confirmation. Run record spec after spec derive, and stop reading rebound from spec derive --json.",
+      "changes": [
+        {
+          "class": "compatibility_policy",
+          "path": "compatibility.json",
+          "surface_entry": null,
+          "summary": "Advance the declared version to 1.53.0."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/effects.v1.json",
+          "surface_entry": "contracts/effects.v1.json",
+          "summary": "Declare the record brief and record spec rows (tier C) and their --dry-run rows (tier none); correct the start, prepare-build and build notes (refused without --force when the report carries stage evidence, stage history or operator decisions) and their --force notes (completed build, Polish and QA records are archived into stage history, which is kept); state that record build writes input_change and makes Polish and QA owed when it detects a brief or CampaignSpec change; and state that record polish, record theme and record deploy are refused while an earlier stage is owed again."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/supported-surface.json",
+          "surface_entry": "contracts/supported-surface.json",
+          "summary": "Advance surface_version to 1.53.0 and record the effects contract hash."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Describe CampaignSpec material changes for local-spec, saved-Map and gateway packets, record spec, spec derive no longer rebinding identity, and the brief and CampaignSpec dependency map."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/campaign-build-brief.md",
+          "surface_entry": "docs/campaign-build-brief.md",
+          "summary": "Replace Answering The Questions with saving answers through record brief, the brief_mode rule, which changes make which stages owed again, stage history, --deviation-reason, and the one-time re-proof of records made before 1.53.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/effects.md",
+          "surface_entry": "docs/effects.md",
+          "summary": "Describe what record brief and record spec write and refuse, their dry runs, and the intake refusal and --force archive."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/local-setup.md",
+          "surface_entry": "docs/local-setup.md",
+          "summary": "Pin the 1.53.0 package in the local setup install command."
+        },
+        {
+          "class": "documentation",
+          "path": "docs/orientation-contract-reference.md",
+          "surface_entry": "docs/orientation-contract-reference.md",
+          "summary": "Regenerate at surface 1.53.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/progress-snapshots.md",
+          "surface_entry": "docs/progress-snapshots.md",
+          "summary": "Stage records carry each stage's effective status: a stage owed again by a brief or CampaignSpec change reads required, and one whose inputs cannot be confirmed reads unknown."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/readback.md",
+          "surface_entry": "docs/readback.md",
+          "summary": "The STAGES header prints the recorded and the effective report status, and a stage line whose effective status differs adds the recorded status and the reason."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/runtime-readiness.md",
+          "surface_entry": "docs/runtime-readiness.md",
+          "summary": "Regenerate at surface 1.53.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Use the current 1.53.0+skills.1 bundle in executable examples."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "package-lock.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.53.0."
+        },
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.53.0."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance the bundled skill revision to 1.53.0+skills.1 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.1 bundle revision."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "record",
+          "summary": "Add record brief and record spec to the usage text; intake binds the brief material and refuses to discard operator state without --force; QA records stamp their inputs; next carries input_currency, offers refresh_inputs and notes an operator's unchanged-output decision in the QC handoff; spec derive no longer rebinds report identity, drops the rebound result field and names record spec."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": "doctor",
+          "summary": "Doctor reports input currency in derived.input_currency and warns spec.material_stale, spec.binding_unknown, build_brief.material_changed, build_brief.binding_unknown, build_brief.input_unsaved, assembly.output_unchanged_after_input_change and assembly.output_unchanged_by_operator_decision; a normalized brief that is not valid JSON, or not a JSON object, is the build_brief.normalized_path error, not a crash."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/next-step.mjs",
+          "surface_entry": "next",
+          "summary": "The stage picker reads each stage's effective status, so a stage owed again by a brief or CampaignSpec change, or one whose inputs cannot be confirmed, is the stage next recommends."
+        }
+      ],
+      "entry_sha256": "85e37bd6392dcfa8415a654897eb8dbe8ab417fc9c92ec21732d2fff5a5f5f5b"
+    },
+    {
+      "id": "RL-0234",
+      "sequence": 226,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.53.0+agent.1",
+      "changelog_sha256": "b865a430b924ff48016930621ba3905deb7861516d9dfdabfd797ed5aaebf6db",
+      "agent_impact": "polish capture now measures text readability on every built page at desktop and mobile widths and attaches it as stages.polish.evidence.visual_review.readability; next lists readability.contrast warnings, review and coverage results in its QC handoff, grouping each warning colour pair across pages and widths for one checkpoint accept. On a campaign whose every mapped page is template stock, polish capture measures readability, prints the page-load no_capturable_routes message as a warning, and exits 0 with status captured_with_warnings; record polish still refuses a completed Polish record there. Polish media weight and readability results read as stale when doctor reports the built output changed since record build. Readability results never block Polish or change readiness. QA's browser-primary-cta check now runs on every page with an expected_next_url, whatever its page type, and measures every visible route-matching CTA (not only the most readable one) and each piece of text inside it, unrounded, with the same measurement Polish uses, against the requirement for its own size; its evidence lists each candidate's elements[] with contrast_ratio_exact and required_ratio. A CTA observed incompletely (the SDK, stylesheets, fonts or its text not ready, a review trigger, text generated by ::before or ::after, or disabled controls) reads manual_review at severity warn, never pass, and so does a page whose inspection script errors (inspection_error, earlier a fail). So browser-primary-cta results on existing campaigns can change in either direction: pages that were skipped are now checked, a second CTA or child text can now fail, large bold text at 3:1 can now pass, and incomplete observations read manual_review instead of pass or fail. The brand theme generator compares contrast unrounded, so a declared colour in [4.495, 4.5) now adds theme.foreground.low_contrast; generated CSS and colour choices are unchanged.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "polish",
+          "summary": "polish capture attaches the readability record beside page_load (which now carries captured_at), and on a campaign with no mapped pages measures readability only, reports the held page-load message as a warning and exits 0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Describe accepting a readability warning: one colour pair and size class per page and width, what orphans or lapses the accept, and that it never hides review, unexercised or excluded results."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/brand-theme-bridge.md",
+          "surface_entry": "docs/brand-theme-bridge.md",
+          "summary": "State that theme contrast uses the same unrounded measurement as Polish and QA, so a declared colour at 4.495:1 now warns, and that the generator's colour choices are unchanged."
+        }
+      ],
+      "entry_sha256": "b75e489a53ea7b60a3a9b3037f6f17c96b13c2960a1cbd34eb7a3cc69b54f617"
+    },
+    {
+      "id": "RL-0235",
+      "sequence": 227,
+      "date": "2026-10-05",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.53.0+agent.2",
+      "changelog_sha256": "a7fc7d90ee83e6ad44d310d77942e00de56656259e9c754eec14cd5bd8d124d4",
+      "agent_impact": "next prints a campaign intent summary, generated from the normalized Campaign Build Brief, on every result (intent_summary in JSON, a Campaign intent section in text) and at the top of the setup, build, Polish and QA prompts. Each value carries its origin (stated, from the source, default, not stated, or source not recorded); values are quoted data, purpose and palette source inferred from page types or names read not stated, and nothing reads the summary, so it never sets prices or commerce behaviour. The four agent context files and the setup, build, Polish and QA skills tell agents to read .campaign-runtime/input/campaign-build-brief.normalized.json and the recorded assembly decisions. Bundled skills carry revision 1.53.0+skills.2: an agent that loaded an earlier revision should start a fresh session. The lifecycle skill returns the single compact brief in references/session-intake.md (Intent: is now Work:, with a new Campaign: field and Proof policy:) and saves brief answers with record brief after asking the operator; the build skill passes --deviation-reason only on the operator's explicit decision, the Polish skill records a skipped Polish only on the operator's decision, and the Polish and QA skills report readability warnings and offer repairs inside the brand palette. tooling setup refuses an installed agent context from an earlier release and names install-agent-context --target . in its refusal.",
+      "compatibility": "breaking",
+      "migration": "From each existing campaign folder: install the exact 1.53.0 package, run npx --no-install campaigns-os install-agent-context --target . (it overwrites all four files under .campaign-runtime/agent-context/; local edits there are lost), review and commit the diff, rerun npx --no-install campaigns-os tooling setup --target . --platform claude, and restart the agent session. Codex, Cursor and Copilot users run install-agent-context and reinstall skills with install-skills --platform codex (or agents).",
+      "changes": [
+        {
+          "class": "documentation",
+          "path": "agents/claude/CLAUDE.md",
+          "surface_entry": "agents/claude/CLAUDE.md",
+          "summary": "Add the generic campaign paragraph: what a NEXT campaign is, who owns creative intent and commerce behaviour, read the normalized brief and the recorded decisions before changing a campaign, treat the intent summary as orientation only, and ask the operator before saving brief answers."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/codex/AGENTS.md",
+          "surface_entry": "agents/codex/AGENTS.md",
+          "summary": "Add the generic campaign paragraph: what a NEXT campaign is, who owns creative intent and commerce behaviour, read the normalized brief and the recorded decisions before changing a campaign, treat the intent summary as orientation only, and ask the operator before saving brief answers."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/copilot/copilot-instructions.md",
+          "surface_entry": "agents/copilot/copilot-instructions.md",
+          "summary": "Add the generic campaign paragraph: what a NEXT campaign is, who owns creative intent and commerce behaviour, read the normalized brief and the recorded decisions before changing a campaign, treat the intent summary as orientation only, and ask the operator before saving brief answers."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/cursor/campaigns-os.mdc",
+          "surface_entry": "agents/cursor/campaigns-os.mdc",
+          "summary": "Add the generic campaign paragraph: what a NEXT campaign is, who owns creative intent and commerce behaviour, read the normalized brief and the recorded decisions before changing a campaign, treat the intent summary as orientation only, and ask the operator before saving brief answers."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Use the current 1.53.0+skills.2 bundle in executable examples."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance the bundled skill revision to 1.53.0+skills.2 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision; read the normalized brief and the recorded decisions; rebuild after an input change and pass --deviation-reason to record build only on the operator's explicit decision, quoting their reason."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision; read the normalized brief and the recorded decisions."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision; return the compact brief defined in references/session-intake.md instead of a second copy, rename the Intent and Proof depth fields to Work and Proof policy, save brief answers with record brief after asking the operator, and declare a detour with --deviation-reason only when the operator has decided on it in the conversation, quoting their reason, including on record build after an input change."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/references/session-intake.md",
+          "surface_entry": null,
+          "summary": "The single compact brief: Intent becomes Work, a Campaign field takes the Campaign intent lines from next, Missing inputs covers only choices that affect this revision, and brief answers are saved with record brief after asking the operator."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision; read the normalized brief and the recorded decisions; record a skipped Polish only on the operator's decision, quoting their reason as skip_reason; report readability warnings and offer repairs inside the brand palette, accepting one only with the operator's refs, reason and name."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "Publish the 1.53.0+skills.2 bundle revision; read the normalized brief and the recorded decisions; report readability warnings and offer repairs inside the brand palette, accepting one only with the operator's refs, reason and name."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": "next",
+          "summary": "next carries intent_summary on every result and prints a Campaign intent section under the status; the setup, build, Polish and QA prompts start with the summary and the absolute normalized brief path, and the build prompt names record brief and record spec for refreshing a changed brief or CampaignSpec."
+        }
+      ],
+      "entry_sha256": "197929e76610b701b015cac7ee37f1f8a75b18e350a8268b679b8ca51a9b7f14"
     }
   ]
 }