@nextcommerce/campaigns-os 1.60.0 → 1.61.0

package/contracts/release-ledger.json

@@ -8651,6 +8651,774 @@
         }
       ],
       "entry_sha256": "25d3db88fb7e0259e9b3a4b91244cf504d0bd99bfc815ab60393b3982927564f"
+    },
+    {
+      "id": "RL-0280",
+      "sequence": 268,
+      "date": "2026-10-20",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.1",
+      "changelog_sha256": "d83b499fd21495ba4520b374856b9b3693c5040ec85c3b60e5669ec6c9038456",
+      "agent_impact": "qa run --site with --base-url set to the site origin and --slug <slug> now loads pages under /<slug>/ instead of the origin root. Passing the origin or the campaign root both work; a workaround that put the slug in --base-url keeps working unchanged.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Say that qa run --site accepts the site origin or the campaign root as --base-url."
+        }
+      ],
+      "entry_sha256": "6fd5e26ac8593f53e2037590e19dc4bc8e0327e0c162c6919542773ba96fcd8b"
+    },
+    {
+      "id": "RL-0281",
+      "sequence": 269,
+      "date": "2026-10-21",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.3",
+      "changelog_sha256": "961b0a16ed510921583ca73e05a37ea0eb0dd235dfacab69627ce295e5de532c",
+      "agent_impact": "Doctor may now warn built_output.sdk_markup.page_type_attribute (data-next-page-type with no next-page-type meta) or built_output.sdk_markup.upsell_page_type_missing (a data-next-upsell offer page whose next-page-type meta is not upsell). Fix either by adding <meta name=\"next-page-type\" content=\"<type>\">, with upsell on upsell offer pages. tooling status now names the harnesses a partial skills refresh is for; a refresh named for another harness is not this session's step.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "List the PAGE_TYPE_ATTRIBUTE and UPSELL_PAGE_TYPE_MISSING SDK markup warnings and what silences each."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/campaigns-os-build-flow.md",
+          "surface_entry": "docs/campaigns-os-build-flow.md",
+          "summary": "Name the next-page-type meta rule and the two new SDK markup warning codes."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": null,
+          "summary": "tooling status names the harnesses a per-platform skills refresh is for."
+        }
+      ],
+      "entry_sha256": "b2b7c61bf3ba87e1d9f730f33a07335f74230b0ece0b94a0370d4de5af1e7859"
+    },
+    {
+      "id": "RL-0282",
+      "sequence": 270,
+      "date": "2026-10-22",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.4",
+      "changelog_sha256": "ca36481b49829528ff6a39bc926f7039836444064fac7bc30b9006169025404b",
+      "agent_impact": "An agent running next-campaigns-sdk-bump reads per-slug live status from the target CLAUDE.md, asks when it is missing or unclear, and places test orders only on the live slugs and orders the developer confirms; names the analytics vendors before asking for test orders; pins the market with ?currency=<main>&country=<main> (not geolocation), confirms the shown market, and passes --currency <main> to qa run; places orders by hand for a non-US main market; never uses ?ignore=true; proves one fresh and five cached loads per SDK page, excluding the receipt and pages with hand-wired purchase pushes from the reloads; runs doctor --built once per bumped slug and qa run --site once per live slug with an exactly matching --family and --slug; covers payment methods the range adds; and asks before the first project-local install, committing its devDependencies change. Doctor now reports sdk_attribute_index_version 0.4.43 and checks cart placeholders on pages pinned to 0.4.43. Re-run tooling status --skills-revision 1.60.0+skills.2 and start a fresh session on mismatch.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance bundle revision to 1.60.0+skills.2 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-sdk-bump/SKILL.md",
+          "surface_entry": null,
+          "summary": "Add funnel liveness, up-front runner gates, the --family source, the currency/country pin, analytics beacon handling, the 1 fresh + 5 cached reload bar, and the install pin commit."
+        },
+        {
+          "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-os-setup/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-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/campaign-lifecycle-orientation/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/campaign-readback-classification/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": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Update current bundle revision examples to 1.60.0+skills.2."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Name v0.4.43 as the vendored SDK attribute index tag."
+        }
+      ],
+      "entry_sha256": "4d3c9b7e4b2441d68a54e2e2197bcba437331ffd8f5acd2f0b952892c74ce7ab"
+    },
+    {
+      "id": "RL-0283",
+      "sequence": 271,
+      "date": "2026-10-22",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.5",
+      "changelog_sha256": "692548da2c57bc653684cc367f546188eee7104220c40ac2d72b6119399ec081",
+      "agent_impact": "An agent running qa run test orders for a non-US market can pass --test-country, --test-address1, --test-city, --test-province and --test-postal (and --test-first-name, --test-last-name, --test-phone) as supported flags instead of ordering by hand; the defaults are unchanged (a US address). A non-USD --currency on an ordering run with no --test-country prints a warning and still runs. qa run --site takes --currency as packet QA does. next-campaigns-sdk-bump step 6 names the address flags, with ordering by hand as the fallback. Re-run tooling status --skills-revision 1.60.0+skills.3 and start a fresh session on mismatch.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": null,
+          "summary": "The qa run usage line lists --test-email and the --test-country, --test-address1, --test-city, --test-province and --test-postal address flags."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Document the test customer and shipping address flags with their defaults, the non-USD --currency warning, and qa run --site --currency."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance bundle revision to 1.60.0+skills.3 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-sdk-bump/SKILL.md",
+          "surface_entry": null,
+          "summary": "Step 6 names the --test-* address flags for non-US orders through the runner, keeping ordering by hand as the fallback."
+        },
+        {
+          "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-os-setup/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-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/campaign-lifecycle-orientation/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/campaign-readback-classification/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": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Update current bundle revision examples to 1.60.0+skills.3."
+        }
+      ],
+      "entry_sha256": "76a1640cd613f80731dafcb8c44efe421026bdd3f79ca28bab19c538193307ae"
+    },
+    {
+      "id": "RL-0284",
+      "sequence": 272,
+      "date": "2026-10-22",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.6",
+      "changelog_sha256": "a03817e639651688a5f17db7e826eaac34bef5002b51a50abd8f5cb31a0e9a4a",
+      "agent_impact": "An agent reading sdk storage-check output for a target outside the manifest range sees the covered range and the uncovered target in the first line and the count line, and in --json reads targetCovered:false; result and exit status (unknown, 2) are unchanged. Unknown lines inside a prefix loop over a scoped SDK key end in [prefix loop: <prefix>] and carry prefixScan in --json; they remain unknown and are explained by one note under the findings.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/sdk-storage-compatibility.md",
+          "surface_entry": "docs/sdk-storage-compatibility.md",
+          "summary": "Describe the out-of-range header, targetCovered, and the [prefix loop] hint with its prefixScan field."
+        }
+      ],
+      "entry_sha256": "0105b7be6bdbdc6e0f8e5a9b2b2a4b5ad3106e9bc7db72029c0cae05d8372fd1"
+    },
+    {
+      "id": "RL-0285",
+      "sequence": 273,
+      "date": "2026-10-22",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.7",
+      "changelog_sha256": "7096f90073a3bacfa53548a266f0a496d2ecacd4a7de0b92b1b6304cf3fcf80d",
+      "agent_impact": "Installed users can continue from the Build Packet into the existing source-intake and CampaignSpec v5 authoring guidance without a source checkout. Repository-only references have explicit public URLs.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Include the five existing public continuation guides in the npm package."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/qa-and-test-orders.md",
+          "surface_entry": "docs/qa-and-test-orders.md",
+          "summary": "Link the repository-only migration case study by its public URL rather than a missing installed path."
+        }
+      ],
+      "entry_sha256": "013f64e2936a0368e8869bc95a7dce1074c6cbcb7243b6b12b237350fea80490"
+    },
+    {
+      "id": "RL-0286",
+      "sequence": 274,
+      "date": "2026-10-23",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.8",
+      "changelog_sha256": "b38963eb35fd2bb130d4709b3cf0c55e3a95e0795cd332b5ad1e3298f6a5af88",
+      "agent_impact": "Read evidence_debt before revising a campaign and renew owed Polish/QA evidence for the current build. Use doctor --ci for a standing PR check, with exits 0 current, 3 owed, 4 unknown and 2 for packet usage errors. The example reports evidence findings by default; enforcement requires CAMPAIGNS_OS_EVIDENCE_CHECK=fail. Installed agent context carries the live-revision procedure, and install-agent-context --dry-run previews destination content without writes.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "documentation",
+          "path": "agents/claude/CLAUDE.md",
+          "surface_entry": "agents/claude/CLAUDE.md",
+          "summary": "Add the live-campaign revision procedure and report-only standing evidence check to installed Claude context."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/codex/AGENTS.md",
+          "surface_entry": "agents/codex/AGENTS.md",
+          "summary": "Add the live-campaign revision procedure and report-only standing evidence check to installed Codex context."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/copilot/copilot-instructions.md",
+          "surface_entry": "agents/copilot/copilot-instructions.md",
+          "summary": "Add the live-campaign revision procedure and report-only standing evidence check to installed Copilot context."
+        },
+        {
+          "class": "documentation",
+          "path": "agents/cursor/campaigns-os.mdc",
+          "surface_entry": "agents/cursor/campaigns-os.mdc",
+          "summary": "Add the live-campaign revision procedure and report-only standing evidence check to installed Cursor context."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/build-packet.md",
+          "surface_entry": "docs/build-packet.md",
+          "summary": "Document doctor --ci evidence assessment, output, exit codes and --no-live-refs usage."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/campaigns-os-build-flow.md",
+          "surface_entry": "docs/campaigns-os-build-flow.md",
+          "summary": "Document the standing campaign PR workflow, report-only default, enforcement opt-in and evidence renewal."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/readback.md",
+          "surface_entry": "docs/readback.md",
+          "summary": "Document additive evidence_debt, its closed statuses, build bindings and retained-manifest change lists without claiming JSON Schema coverage."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": null,
+          "summary": "Expose doctor --ci and preview installed agent-context destinations and full content under --dry-run."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/ci.mjs",
+          "surface_entry": null,
+          "summary": "Assess build-bound Polish/QA debt and format escaped PR reports with current, owed, unknown and usage exit codes."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/inspect.mjs",
+          "surface_entry": null,
+          "summary": "Add the shared CI evidence assessment to packet doctor inspection without changing ordinary doctor behavior."
+        }
+      ],
+      "entry_sha256": "1373ad7544a503609699964287cb7a94e5ab6c4f9032b3c085dd511008a77a87"
+    },
+    {
+      "id": "RL-0287",
+      "sequence": 275,
+      "date": "2026-10-23",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.9",
+      "changelog_sha256": "79a868508959f46da073ab22d5201bf6726d779c2259c086e6b9dc311176ae9b",
+      "agent_impact": "Run polish capture again after upgrading before recording completed Polish. New writes require current package captures; existing records retain legacy reads. Visual reference warnings and diff diagnostics appear in the QC handoff; pixel scores never decide fidelity.",
+      "compatibility": "compatible",
+      "migration": "Run polish capture before the next completed record polish; never author visual_review.captures by hand.",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/design-source-package.md",
+          "surface_entry": "docs/design-source-package.md",
+          "summary": "Document screenshot pixel ratio, dimensions and declared source lineage."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Update current bundle revision examples to 1.60.0+skills.4."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "package-lock.json",
+          "surface_entry": null,
+          "summary": "Pin the optional visual comparison dependency graph."
+        },
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Add optional PNG decoder and pixel comparison dependencies."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": null,
+          "summary": "Advance the Polish skill to 1.1.49, every other skill one patch, and the bundle to 1.60.0+skills.4."
+        },
+        {
+          "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": "Require package captures for completed Polish and present diagnostic review findings."
+        },
+        {
+          "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."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": null,
+          "summary": "Capture package visual evidence and report its diagnostic summary."
+        }
+      ],
+      "entry_sha256": "6db2be5bbde95ca81448ab4d82212f995536fb2ebbd75008de71a056286df912"
+    },
+    {
+      "id": "RL-0288",
+      "sequence": 276,
+      "date": "2026-10-23",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "1.60.0+agent.10",
+      "changelog_sha256": "edca023e7644eebe59a8d52df16cadf8e1fea2dfe3fde6fdb0b74c74b63ee390",
+      "agent_impact": "theme generate can now write .campaign-runtime/theme/brand-fonts.css beside brand-theme.css, and brand-theme.css can carry next-core font-family tokens in a `:root, body` block plus --radius-size--buttons. When brand-fonts.css exists, a build agent copies it into the campaign assets/css folder and loads it on the same commerce pages as the brand layer; record theme refuses a styled page that does not. Sources without self-hosted brand faces generate the same CSS as before.",
+      "compatibility": "additive",
+      "migration": "none",
+      "changes": [
+        {
+          "class": "named_surface",
+          "path": "docs/brand-theme-bridge.md",
+          "surface_entry": "docs/brand-theme-bridge.md",
+          "summary": "New Typography section: what inspection reads, the three next-core targets, the :root, body block, brand-fonts.css, and the record theme requirement."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/campaigns-os-build-flow.md",
+          "surface_entry": "docs/campaigns-os-build-flow.md",
+          "summary": "Build copies and loads brand-fonts.css beside brand-theme.css when theme generate wrote one."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Examples name bundle revision 1.60.0+skills.5."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": null,
+          "summary": "Build guidance and the prepare-build theme evidence line name brand-fonts.css alongside brand-theme.css."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance bundle revision to 1.60.0+skills.5 and each skill version one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Copy and load brand-fonts.css with the brand layer when theme generate wrote one."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Check font parity at a mobile width as well as desktop."
+        },
+        {
+          "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-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-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": "a3a9fd429e90c43fe9870f9ea92cb8b0abff84f4e2698cba04175337d1d71289"
+    },
+    {
+      "id": "RL-0289",
+      "sequence": 277,
+      "date": "2026-10-23",
+      "kind": "release",
+      "surface_version": "1.61.0",
+      "changelog_section": "1.61.0",
+      "changelog_sha256": "602057600e181bcd5c5fe3be78eba1bbd70e5af9f10780249a98b83978ad9572",
+      "agent_impact": "The 1.61.0 package publishes 1.60.0+agent.7 through agent.10, adds manifest-declared or Figma-spec export-provenance-backed design-file authority and element-level Polish comparisons for operator review, and describes readback evidence debt in the published schema. Refresh bundled skills to 1.61.0+skills.1; unknown design access or evidence debt is not proof that review is complete.",
+      "compatibility": "additive",
+      "migration": "Update the pinned package and refresh installed skills to 1.61.0+skills.1. Run polish capture again before the next completed record polish. After changing built output, renew any owed Polish and QA evidence.",
+      "changes": [
+        {
+          "class": "compatibility_policy",
+          "path": "compatibility.json",
+          "surface_entry": "compatibility.json",
+          "summary": "Name 1.61.0 as the release package version."
+        },
+        {
+          "class": "compatibility_policy",
+          "path": "contracts/supported-surface.json",
+          "surface_entry": "contracts/supported-surface.json",
+          "summary": "Advance the surface to 1.61.0 and refresh the design-source, source-html manifest and readback schema hashes."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/campaign-build-brief.md",
+          "surface_entry": "docs/campaign-build-brief.md",
+          "summary": "Describe design-file authority under its own section after the brief definition, with Figma-only spec lineage requiring doctor's provenance check to pass without a waiver and unexercised design access."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/design-source-package.md",
+          "surface_entry": "docs/design-source-package.md",
+          "summary": "Document manifest design-file declarations, Figma-only provenance-gated intake, comparison of recorded spec files regardless of current manifest availability, source-HTML element parity, file-only identity and missing-declaration recovery."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/local-setup.md",
+          "surface_entry": "docs/local-setup.md",
+          "summary": "Pin the documented toolkit installation to 1.61.0."
+        },
+        {
+          "class": "documentation",
+          "path": "docs/orientation-contract-reference.md",
+          "surface_entry": "docs/orientation-contract-reference.md",
+          "summary": "Regenerate the orientation reference at surface 1.61.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/readback.md",
+          "surface_entry": "docs/readback.md",
+          "summary": "State that the readback schema now describes the additive evidence_debt field."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/runtime-readiness.md",
+          "surface_entry": "docs/runtime-readiness.md",
+          "summary": "Regenerate runtime readiness at surface 1.61.0."
+        },
+        {
+          "class": "named_surface",
+          "path": "docs/skills-revision.md",
+          "surface_entry": "docs/skills-revision.md",
+          "summary": "Show the 1.61.0+skills.1 bundle identity in preflight examples."
+        },
+        {
+          "class": "generated_runtime",
+          "path": "package-lock.json",
+          "surface_entry": null,
+          "summary": "Advance the two root package version stamps to 1.61.0 without changing dependency resolutions."
+        },
+        {
+          "class": "package_export",
+          "path": "package.json",
+          "surface_entry": null,
+          "summary": "Advance the package version to 1.61.0."
+        },
+        {
+          "class": "schema",
+          "path": "schemas/campaign-design-source-package.v0.schema.json",
+          "surface_entry": "schemas/campaign-design-source-package.v0.schema.json",
+          "summary": "Describe the optional design-file type and derived_from contribution lineage."
+        },
+        {
+          "class": "schema",
+          "path": "schemas/campaigns-os-readback.v2.schema.json",
+          "surface_entry": "schemas/campaigns-os-readback.v2.schema.json",
+          "summary": "Describe optional evidence_debt stage statuses, reasons and assembly-manifest changes, and make owed evidence explicit in the clean rule."
+        },
+        {
+          "class": "schema",
+          "path": "schemas/source-html-manifest.v0.schema.json",
+          "surface_entry": "schemas/source-html-manifest.v0.schema.json",
+          "summary": "Accept optional design_file declarations while preserving non-fatal warnings for malformed values."
+        },
+        {
+          "class": "skill",
+          "path": "skills.json",
+          "surface_entry": "skills.json",
+          "summary": "Advance the bundle to 1.61.0+skills.1 and every bundled skill by one patch."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-lifecycle-orientation/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-readback-classification/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/campaign-run-evidence/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/contribution-intake/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-build/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os-setup/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-os/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch, stamp bundle 1.61.0+skills.1, and give the manifest design_file object shape and the design-source package documentation for Figma-only spec lineage."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-polish/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch, stamp bundle 1.61.0+skills.1, and explain parity.element review, unexercised design.access and changed, missing or conflicting file recovery in the nonblocking Polish handoff."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-qa/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "skill",
+          "path": "skills/next-campaigns-sdk-bump/SKILL.md",
+          "surface_entry": null,
+          "summary": "Bump the skill one patch and stamp bundle 1.61.0+skills.1."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/cli.mjs",
+          "surface_entry": null,
+          "summary": "Record declared design-file references in the drafted Build Brief at prepare-build, and attach the capture's element-parity record to Polish evidence."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/checks.mjs",
+          "surface_entry": null,
+          "summary": "Report nonblocking design.access with separate changed, conflicting and missing declaration reviews; doctor first applies today's intake rule, then falls back to a usable Figma spec only for a page with recorded derived_from design-file lineage, regardless of the shared file's producer; preserve the #534 gate."
+        },
+        {
+          "class": "cli_surface",
+          "path": "src/doctor/source-provenance.mjs",
+          "surface_entry": null,
+          "summary": "Share the existing Figma-export provenance findings with intake so only Figma spec declarations backed by the unwaived check establish design-file lineage; preserve #534 findings and waiver semantics, with imports below the header."
+        }
+      ],
+      "entry_sha256": "8c2fc5103b4e74c10d0e9b9ff62369ee7eeb1821a7cc9f0912090fa46ede6165"
     }
   ]
 }