@nextcommerce/campaigns-os 1.33.0

package/contracts/fixtures/sidecar-bundle/production-shaped/.campaign-runtime/assembly-report.json

@@ -0,0 +1,180 @@
+{
+  "schema_version": "campaign-runtime-assembly-report/v0",
+  "run_id": "asm_example",
+  "generated_at": "2026-08-24T00:00:00.000Z",
+  "status": "prepared",
+  "identity": {
+    "map_id": "runtime-packet-demo-k9x2",
+    "public_route_slug": "runtime-packet-demo",
+    "campaign_directory": "runtime-packet-demo",
+    "live_url_path": "/runtime-packet-demo/",
+    "spec_hash": "example-spec-sha256"
+  },
+  "inputs": {
+    "packet_path": "campaign-runtime.build.json",
+    "context_path": ".campaign-runtime/build-context.json",
+    "spec_path": "campaignspec.v42.basic.json",
+    "source": { "kind": "html_funnel", "root": "source-html" },
+    "target_repo": "."
+  },
+  "template_family": {
+    "value": "olympus",
+    "locked": true,
+    "locked_by": "fixture",
+    "commerce_catalog_version": "2",
+    "candidates": []
+  },
+  "stages": {
+    "prepare_build": {
+      "stage": "prepare_build",
+      "status": "completed",
+      "inputs": [],
+      "outputs": ["campaign-runtime.build.json", ".campaign-runtime/build-context.json", ".campaign-runtime/assembly-report.json"],
+      "commands": [],
+      "blockers": [],
+      "warnings": []
+    },
+    "doctor": { "stage": "doctor", "status": "pending", "inputs": [], "outputs": [], "commands": [], "blockers": [], "warnings": [] },
+    "setup": { "stage": "setup", "status": "pending", "inputs": [], "outputs": [], "commands": [], "blockers": [], "warnings": [] },
+    "assembly": { "stage": "assembly", "status": "pending", "inputs": [], "outputs": [], "commands": [], "blockers": [], "warnings": [] },
+    "polish": { "stage": "polish", "status": "pending", "inputs": [], "outputs": [], "commands": [], "blockers": [], "warnings": [] },
+    "deploy": { "stage": "deploy", "status": "pending", "inputs": [], "outputs": [], "commands": [], "blockers": [], "warnings": [] },
+    "qa": { "stage": "qa", "status": "pending", "inputs": [], "outputs": [], "commands": [], "blockers": [], "warnings": [] }
+  },
+  "decisions": [
+    {
+      "id": "dec_page_map_checkout",
+      "stage": "prepare_build",
+      "decision_type": "deterministic_derivation",
+      "decision": "mapped CampaignSpec page \"checkout\" to source file \"checkout.html\"",
+      "evidence_ids": [],
+      "confidence": "high",
+      "blast_radius": "routing",
+      "requires_ack": false,
+      "acknowledged_by": null
+    }
+  ],
+  "adapter_decisions": {
+    "raw_html_conversion_status": "completed",
+    "source_asset_strategy": "pagekit_campaign_asset_root",
+    "route_rewrite_policy": "campaignspec_routes_via_campaign_link",
+    "config_script_strategy": "campaign_asset",
+    "commerce_shell_adoption": "template_clone_first_verified",
+    "wrapper_policy": "strip_document_wrappers",
+    "frontmatter_policy": "pagekit_yaml_frontmatter",
+    "script_style_reference_policy": "frontmatter_or_campaign_asset",
+    "cta_rewrite_policy": "campaignspec_routes_via_campaign_link",
+    "layout_choice": "campaign_layout",
+    "template_files_copied": {
+      "status": "verified_existing_slice",
+      "required_groups": ["pages", "_includes", "_layouts", "assets/css", "assets/js", "frontmatter_vocabulary"],
+      "groups": ["pages", "_includes", "_layouts", "assets/css", "assets/js", "frontmatter_vocabulary"],
+      "paths": ["src/runtime-packet-demo", "src/runtime-packet-demo/_includes", "src/runtime-packet-demo/_layouts", "src/runtime-packet-demo/assets/css", "src/runtime-packet-demo/assets/js"]
+    }
+  },
+  "proof_policy": {
+    "browser_qa_required": true,
+    "typed_card_depth": "common",
+    "localhost_development_domain_allowed": true,
+    "non_localhost_origin_allowlist_required": true,
+    "order_path_depth": "common",
+    "operator_approval_state": "not_required_global_test_cards",
+    "qa_portal_publish_default": true
+  },
+  "evidence": [],
+  "blockers": [],
+  "warnings": [
+    {
+      "code": "SOURCE_COMMERCE_REVIEW",
+      "stage": "assembly",
+      "message": "Source HTML contains possible commerce zones. Build must preserve catalog-owned runtime surfaces."
+    }
+  ],
+  "checklists": {
+    "polish": {
+      "anchor_screenshots": [
+        {
+          "page_type": "checkout",
+          "anchor": "bundle_selector",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["screenshots/checkout-bundle-desktop.png", "screenshots/checkout-bundle-mobile.png"]
+        },
+        {
+          "page_type": "checkout",
+          "anchor": "customer_info",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["screenshots/checkout-customer-desktop.png", "screenshots/checkout-customer-mobile.png"]
+        },
+        {
+          "page_type": "checkout",
+          "anchor": "shipping_address",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["screenshots/checkout-shipping-desktop.png", "screenshots/checkout-shipping-mobile.png"]
+        },
+        {
+          "page_type": "checkout",
+          "anchor": "payment_method",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["screenshots/checkout-payment-desktop.png", "screenshots/checkout-payment-mobile.png"]
+        },
+        {
+          "page_type": "checkout",
+          "anchor": "submit_order_summary",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["screenshots/checkout-submit-desktop.png", "screenshots/checkout-submit-mobile.png"]
+        }
+      ],
+      "state_screenshots": [
+        {
+          "page_type": "checkout",
+          "state": "selected_bundle_tier",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["screenshots/checkout-selected-bundle-desktop.png", "screenshots/checkout-selected-bundle-mobile.png"]
+        }
+      ],
+      "runtime_smoke": [
+        {
+          "page_type": "checkout",
+          "state": "console_clean",
+          "viewports": ["desktop", "mobile"],
+          "evidence": ["logs/checkout-console.txt"]
+        }
+      ]
+    },
+    "template_family": {
+      "family": "olympus",
+      "invariants": [
+        {
+          "id": "olympus.mobile_bundle_horizontal_order",
+          "status": "passed",
+          "evidence": ["screenshots/checkout-selected-bundle-mobile.png"]
+        },
+        {
+          "id": "olympus.checkout_fields_full_width",
+          "status": "passed",
+          "evidence": ["screenshots/checkout-shipping-mobile.png"]
+        },
+        {
+          "id": "olympus.spreedly_no_duplicate_fallback_text",
+          "status": "passed",
+          "evidence": ["screenshots/checkout-payment-mobile.png"]
+        },
+        {
+          "id": "olympus.payment_metadata_no_overlap",
+          "status": "passed",
+          "evidence": ["screenshots/checkout-payment-desktop.png", "screenshots/checkout-payment-mobile.png"]
+        },
+        {
+          "id": "olympus.selected_state_shape_stable",
+          "status": "passed",
+          "evidence": ["screenshots/checkout-selected-bundle-desktop.png", "screenshots/checkout-selected-bundle-mobile.png"]
+        }
+      ]
+    }
+  },
+  "next": {
+    "stage": "setup",
+    "owner": "next-campaigns-os-setup",
+    "action": "Run Page Kit scaffold using the doctor-cleared packet, then hand setup output to build."
+  }
+}

package/contracts/fixtures/sidecar-bundle/production-shaped/.campaign-runtime/build-context.json

@@ -0,0 +1,115 @@
+{
+  "schema_version": "campaign-runtime-build-context/v0",
+  "generated_at": "2026-08-24T00:00:00.000Z",
+  "source_adapter": "html_funnel",
+  "status": "prepared",
+  "packet_path": "campaign-runtime.build.json",
+  "report_path": ".campaign-runtime/assembly-report.json",
+  "spec": {
+    "path": "campaignspec.v42.basic.json",
+    "hash": "example-spec-sha256",
+    "active_pages": [
+      { "id": "landing", "type": "landing", "label": "Landing", "page_url": "landing/" },
+      { "id": "checkout", "type": "checkout", "label": "Checkout", "page_url": "checkout/" }
+    ]
+  },
+  "source": {
+    "root": "source-html",
+    "html_files": [
+      { "path": "landing.html", "name": "landing.html", "basename": "landing", "bytes": 1000, "sha256": "example-html-sha256" },
+      { "path": "checkout.html", "name": "checkout.html", "basename": "checkout", "bytes": 2000, "sha256": "example-html-sha256" }
+    ]
+  },
+  "page_map": [
+    {
+      "page_id": "landing",
+      "source_path": "landing.html",
+      "skip_reason": null,
+      "output_path": "src/runtime-packet-demo/landing.html",
+      "page_kit": {
+        "target_path": "landing.html",
+        "output_path": "src/runtime-packet-demo/landing.html",
+        "public_route": "/runtime-packet-demo/landing/",
+        "spec_route": "landing/",
+        "page_type": "product",
+        "permalink_required": false,
+        "frontmatter": {
+          "page_type": "product",
+          "next_url": "/runtime-packet-demo/checkout/"
+        }
+      }
+    },
+    {
+      "page_id": "checkout",
+      "source_path": "checkout.html",
+      "skip_reason": null,
+      "output_path": "src/runtime-packet-demo/checkout.html",
+      "page_kit": {
+        "target_path": "checkout.html",
+        "output_path": "src/runtime-packet-demo/checkout.html",
+        "public_route": "/runtime-packet-demo/checkout/",
+        "spec_route": "checkout/",
+        "page_type": "checkout",
+        "permalink_required": false,
+        "frontmatter": {
+          "page_type": "checkout"
+        }
+      }
+    }
+  ],
+  "scaffold": {
+    "mode": "fresh",
+    "required": true,
+    "target_repo": ".",
+    "output_dir": "src/runtime-packet-demo",
+    "handoff_skill": "next-campaigns-os-setup",
+    "handoff_artifact": ".campaign-runtime/setup-handoff.json",
+    "reason": "Target campaign output directory is missing; run Page Kit scaffold before build."
+  },
+  "template": {
+    "family": "olympus",
+    "locked": true,
+    "lock": { "locked": true, "locked_by": "fixture", "confidence": "high", "evidence": ["contracts/fixtures/campaign-specs/olympus-tiered-standard-free.json"] },
+    "candidates": []
+  },
+  "adapter_decisions": {
+    "raw_html_conversion_status": "pending",
+    "source_asset_strategy": "pagekit_campaign_asset_root",
+    "route_rewrite_policy": "campaignspec_routes_via_campaign_link",
+    "config_script_strategy": "campaign_asset",
+    "commerce_shell_adoption": "template_clone_first_required",
+    "wrapper_policy": "strip_document_wrappers",
+    "frontmatter_policy": "pagekit_yaml_frontmatter",
+    "script_style_reference_policy": "frontmatter_or_campaign_asset",
+    "cta_rewrite_policy": "campaignspec_routes_via_campaign_link",
+    "layout_choice": "campaign_layout",
+    "template_files_copied": {
+      "status": "pending",
+      "required_groups": ["pages", "_includes", "_layouts", "assets/css", "assets/js", "frontmatter_vocabulary"],
+      "groups": [],
+      "paths": []
+    }
+  },
+  "commerce_zone_findings": [
+    {
+      "path": "checkout.html",
+      "zones": ["checkout", "payment"],
+      "sdk_attributes": [],
+      "action": "review_and_preserve_catalog_surfaces",
+      "note": "HTML source may express visual intent here, but catalog-owned runtime shapes must remain authoritative."
+    }
+  ],
+  "prompts_required": [],
+  "decisions": [
+    {
+      "id": "dec_page_map_checkout",
+      "stage": "prepare_build",
+      "decision_type": "deterministic_derivation",
+      "decision": "mapped CampaignSpec page \"checkout\" to source file \"checkout.html\"",
+      "confidence": "high",
+      "blast_radius": "routing",
+      "requires_ack": false,
+      "evidence": ["matched source filename against page keys: checkout"]
+    }
+  ]
+}

package/contracts/fixtures/sidecar-bundle/production-shaped/.campaign-runtime/doctor-output.json

@@ -0,0 +1,29 @@
+{
+  "schema_version": "campaigns-os-doctor-output/v0",
+  "generated_at": "2026-08-24T00:01:00.000Z",
+  "generated_by": "doctor",
+  "ok": true,
+  "status": "ready_with_warnings",
+  "errors": [],
+  "warnings": [
+    {
+      "code": "deploy.preview_url",
+      "message": "Preview URL is not recorded yet."
+    }
+  ],
+  "ready": [
+    "Build Packet schema campaign-runtime-build-packet/v0",
+    "Build context schema campaign-runtime-build-context/v0"
+  ],
+  "derived": {
+    "packet_path": "campaign-runtime.build.json",
+    "map_id": "runtime-packet-demo-k9x2",
+    "public_route_slug": "runtime-packet-demo",
+    "template_family": "olympus"
+  },
+  "next": {
+    "stage": "deploy",
+    "owner": "campaign-operator",
+    "action": "Record the preview deployment before QA."
+  }
+}

package/contracts/fixtures/sidecar-bundle/production-shaped/.campaign-runtime/qa-verdict.json

@@ -0,0 +1,27 @@
+{
+  "schema_version": "1.0",
+  "run_id": "MSRBUNDLEFIXTURE000000000000",
+  "campaign_slug": "runtime-packet-demo-k9x2",
+  "public_route_slug": "runtime-packet-demo",
+  "spec_version": "4.2",
+  "spec_hash": "example-spec-sha256",
+  "started_at": "2026-08-24T00:02:00.000Z",
+  "completed_at": "2026-08-24T00:03:00.000Z",
+  "generated_at": "2026-08-24T00:04:00.000Z",
+  "runtime": "campaigns-os-node-qa@0.1.0-alpha.0",
+  "disposition": "ready",
+  "entry_urls": [],
+  "page_urls": [],
+  "tested_urls": [],
+  "assertions": [
+    {
+      "id": "http:checkout",
+      "family": "funnel-flow",
+      "page": "checkout",
+      "status": "pass",
+      "severity": "info"
+    }
+  ],
+  "test_orders": [],
+  "exceptions": []
+}

package/contracts/fixtures/sidecar-bundle/production-shaped/campaign-runtime.build.json

@@ -0,0 +1,141 @@
+{
+  "schema_version": "campaign-runtime-build-packet/v0",
+  "generated_at": "2026-08-24T00:00:00.000Z",
+  "campaign": {
+    "public_route_slug": "runtime-packet-demo",
+    "campaign_directory": "runtime-packet-demo",
+    "live_url_path": "/runtime-packet-demo/",
+    "campaigns_app_url": null,
+    "api_key_source": "env:CAMPAIGNS_API_KEY",
+    "allowed_domains_confirmed": true
+  },
+  "spec": {
+    "map_id": "runtime-packet-demo-k9x2",
+    "spec_url": "https://campaign-map.nextcommerce.com/api/spec/runtime-packet-demo-k9x2",
+    "local_path": "campaignspec.v42.basic.json"
+  },
+  "source_html": {
+    "root": "source-html",
+    "pages": [
+      {
+        "page_id": "landing",
+        "path": "landing.html",
+        "page_kit": {
+          "target_path": "landing.html",
+          "output_path": "src/runtime-packet-demo/landing.html",
+          "public_route": "/runtime-packet-demo/landing/",
+          "spec_route": "landing/",
+          "page_type": "product",
+          "permalink_required": false,
+          "frontmatter": {
+            "page_type": "product",
+            "next_url": "/runtime-packet-demo/checkout/"
+          }
+        }
+      },
+      {
+        "page_id": "checkout",
+        "path": "checkout.html",
+        "page_kit": {
+          "target_path": "checkout.html",
+          "output_path": "src/runtime-packet-demo/checkout.html",
+          "public_route": "/runtime-packet-demo/checkout/",
+          "spec_route": "checkout/",
+          "page_type": "checkout",
+          "permalink_required": false,
+          "frontmatter": {
+            "page_type": "checkout",
+            "next_url": "/runtime-packet-demo/upsell/"
+          }
+        }
+      },
+      {
+        "page_id": "upsell",
+        "path": "upsell.html",
+        "page_kit": {
+          "target_path": "upsell.html",
+          "output_path": "src/runtime-packet-demo/upsell.html",
+          "public_route": "/runtime-packet-demo/upsell/",
+          "spec_route": "upsell/",
+          "page_type": "upsell",
+          "permalink_required": false,
+          "frontmatter": {
+            "page_type": "upsell",
+            "next_url": "/runtime-packet-demo/receipt/"
+          }
+        }
+      },
+      {
+        "page_id": "receipt",
+        "path": "receipt.html",
+        "page_kit": {
+          "target_path": "receipt.html",
+          "output_path": "src/runtime-packet-demo/receipt.html",
+          "public_route": "/runtime-packet-demo/receipt/",
+          "spec_route": "receipt/",
+          "page_type": "receipt",
+          "permalink_required": false,
+          "frontmatter": {
+            "page_type": "receipt"
+          }
+        }
+      }
+    ],
+    "adapter_contract": {
+      "raw_html_conversion_status": "pending",
+      "source_asset_strategy": "pagekit_campaign_asset_root",
+      "route_rewrite_policy": "campaignspec_routes_via_campaign_link",
+      "config_script_strategy": "campaign_asset",
+      "commerce_shell_adoption": "template_clone_first_required",
+      "wrapper_policy": "strip_document_wrappers",
+      "frontmatter_policy": "pagekit_yaml_frontmatter",
+      "script_style_reference_policy": "frontmatter_or_campaign_asset",
+      "cta_rewrite_policy": "campaignspec_routes_via_campaign_link",
+      "layout_choice": "campaign_layout",
+      "template_files_copied": {
+        "status": "pending",
+        "required_groups": ["pages", "_includes", "_layouts", "assets/css", "assets/js", "frontmatter_vocabulary"],
+        "groups": [],
+        "paths": []
+      }
+    }
+  },
+  "assembly": {
+    "implementation": "next-campaigns-build",
+    "target_repo": ".",
+    "output_dir": "src/runtime-packet-demo",
+    "template_family": "olympus",
+    "template_decision_notes": "Golden-path fixture locks Olympus for the default prepared-HTML flow; builders may choose Demeter or shop-single-step when those families better match the campaign.",
+    "template_lock": {
+      "locked": true,
+      "locked_by": "fixture",
+      "confidence": "high",
+      "evidence": ["contracts/fixtures/campaign-specs/olympus-tiered-standard-free.json"]
+    },
+    "commerce_catalog": {
+      "required": true,
+      "family": "olympus",
+      "version": "2",
+      "path": "../contracts/commerce-surface-catalog.json"
+    },
+    "compatible_outputs": ["static-html", "campaign-cart-sdk"]
+  },
+  "deploy": {
+    "target": "netlify",
+    "preview_url": null,
+    "production_url": null
+  },
+  "qa": {
+    "proof_policy": {
+      "browser_qa_required": true,
+      "typed_card_depth": "common",
+      "localhost_development_domain_allowed": true,
+      "non_localhost_origin_allowlist_required": true,
+      "order_path_depth": "common",
+      "operator_approval_state": "not_required_global_test_cards",
+      "qa_portal_publish_default": true
+    },
+    "test_order_policy_notes": "Test Orders use global test cards that bypass the gateway and create no transactions. Run them with `qa run --test-order common` by default; use `full` only for exhaustive proof. Localhost on any port is a Development domain for SDK QA; non-localhost preview/production origins still need SDK origin allowlist confirmation. These flags are informational, not a permission gate."
+  },
+  "notes": "Synthetic v0 example. Values must be replaced with actual CampaignSpec/API values for a real campaign."
+}

package/contracts/migration-sidecar-bundle.v0.json

@@ -0,0 +1,149 @@
+{
+  "schema_version": "campaigns-os-migration-sidecar-bundle-contract/v0",
+  "bundle_id": "campaigns-os-migration-sidecar-bundle/v0",
+  "packet_discovery": {
+    "canonical_path": "campaign-runtime.build.json",
+    "legacy_path": ".campaign-runtime/campaign-runtime.build.json",
+    "selection_authority": "campaign-runtime.build.json#generated_at",
+    "forbidden_selection_authority": "filesystem_mtime",
+    "legacy_remedy": "Regenerate or move the Build Packet to repository-root campaign-runtime.build.json, then refresh the canonical sidecars.",
+    "noncanonical_remedy": "Run bundle check against the repository-root campaign-runtime.build.json. If this packet is authoritative, move or regenerate it there, then refresh the canonical sidecars."
+  },
+  "artifacts": [
+    {
+      "kind": "build_packet",
+      "path": "campaign-runtime.build.json",
+      "requirement": "required",
+      "schema_version": "campaign-runtime-build-packet/v0",
+      "schema_path": "schemas/campaign-runtime-build-packet.v0.schema.json",
+      "freshness_field": "generated_at",
+      "volatile_fields": ["generated_at"]
+    },
+    {
+      "kind": "build_context",
+      "path": ".campaign-runtime/build-context.json",
+      "requirement": "required",
+      "schema_version": "campaign-runtime-build-context/v0",
+      "schema_path": "schemas/campaign-runtime-build-context.v0.schema.json",
+      "freshness_field": "generated_at",
+      "volatile_fields": ["generated_at"]
+    },
+    {
+      "kind": "assembly_report",
+      "path": ".campaign-runtime/assembly-report.json",
+      "requirement": "required",
+      "schema_version": "campaign-runtime-assembly-report/v0",
+      "schema_path": "schemas/campaign-runtime-assembly-report.v0.schema.json",
+      "freshness_field": "generated_at",
+      "volatile_fields": ["generated_at", "run_id"]
+    },
+    {
+      "kind": "doctor_output",
+      "path": ".campaign-runtime/doctor-output.json",
+      "requirement": "required",
+      "schema_version": "campaigns-os-doctor-output/v0",
+      "schema_path": "schemas/campaigns-os-doctor-output.v0.schema.json",
+      "freshness_field": "generated_at",
+      "volatile_fields": ["generated_at", "stale_marked_at"]
+    },
+    {
+      "kind": "qa_verdict",
+      "path": ".campaign-runtime/qa-verdict.json",
+      "requirement": "required_after_qa",
+      "schema_version": "1.0",
+      "schema_path": "schemas/campaigns-os-qa-verdict-sidecar.v0.schema.json",
+      "freshness_field": "generated_at",
+      "volatile_fields": ["generated_at", "started_at", "completed_at", "run_id"]
+    }
+  ],
+  "identity_fields": [
+    {
+      "name": "map_id",
+      "artifact_paths": {
+        "build_packet": "spec.map_id",
+        "assembly_report": "identity.map_id",
+        "doctor_output": "derived.map_id",
+        "qa_verdict": "campaign_slug"
+      }
+    },
+    {
+      "name": "public_route_slug",
+      "artifact_paths": {
+        "build_packet": "campaign.public_route_slug",
+        "assembly_report": "identity.public_route_slug",
+        "doctor_output": "derived.public_route_slug",
+        "qa_verdict": "public_route_slug"
+      }
+    },
+    {
+      "name": "campaign_directory",
+      "artifact_paths": {
+        "build_packet": "campaign.campaign_directory",
+        "assembly_report": "identity.campaign_directory"
+      }
+    },
+    {
+      "name": "live_url_path",
+      "artifact_paths": {
+        "build_packet": "campaign.live_url_path",
+        "assembly_report": "identity.live_url_path"
+      }
+    },
+    {
+      "name": "template_family",
+      "artifact_paths": {
+        "build_packet": "assembly.template_family",
+        "build_context": "template.family",
+        "assembly_report": "template_family.value",
+        "doctor_output": "derived.template_family"
+      }
+    },
+    {
+      "name": "spec_hash",
+      "artifact_paths": {
+        "build_context": "spec.hash",
+        "assembly_report": "identity.spec_hash"
+      },
+      "meaning": "Exact raw-byte integrity for the authored CampaignSpec. This identity is never compared with QA's semantic spec hash."
+    },
+    {
+      "name": "spec_material_hash",
+      "artifact_paths": {
+        "build_context": "spec.material_hash",
+        "assembly_report": "identity.spec_material_hash",
+        "qa_verdict": "spec_hash"
+      },
+      "meaning": "Canonical CampaignSpec material identity used for cross-producer QA correlation.",
+      "compatibility": {
+        "mode": "complete_material_or_strict_legacy_exact",
+        "legacy_artifact_paths": {
+          "build_context": "spec.hash",
+          "assembly_report": "identity.spec_hash"
+        },
+        "rule": "When neither producer has a material identity, compare the legacy producer raw-byte values exactly and do not compare them with QA's semantic spec hash. When either producer has a material identity, every present bundle artifact must carry the material identity. Mixed producer generations fail closed."
+      }
+    }
+  ],
+  "repository_relative_paths": {
+    "equivalent_spellings": ["campaign-runtime.build.json", "./campaign-runtime.build.json"],
+    "forbidden": ["absolute", "uri", "backslash", "parent_traversal"],
+    "rule": "Normalize only empty and current-directory segments before comparing canonical repository-relative artifact names."
+  },
+  "ci_producer": {
+    "refresh_doctor": "campaigns-os doctor --packet campaign-runtime.build.json --strip-paths --json",
+    "promote_historical_qa": "campaigns-os qa promote --packet campaign-runtime.build.json --verdict <explicit-full-verdict.json> --json",
+    "check_base_bundle": "campaigns-os bundle check --packet campaign-runtime.build.json --json",
+    "check_qa_complete_bundle": "campaigns-os bundle check --packet campaign-runtime.build.json --require-qa --json",
+    "preserve_authored": [
+      "campaign-runtime.build.json",
+      ".campaign-runtime/build-context.json",
+      ".campaign-runtime/assembly-report.json"
+    ],
+    "never_select_qa_by": ["filesystem_mtime", "filename_sort", "directory_latest"]
+  },
+  "compatibility": {
+    "markdown_may_coexist": true,
+    "markdown_is_readback_truth": false,
+    "migration_specific_scripts_are_contract": false
+  }
+}