@nextcommerce/campaigns-os 1.33.0

package/schemas/campaign-runtime-assembly-report.v0.schema.json

@@ -0,0 +1,390 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://nextcommerce.com/schemas/campaign-runtime-assembly-report.v0.schema.json",
+  "title": "Campaigns OS Assembly Report v0",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "run_id",
+    "generated_at",
+    "status",
+    "identity",
+    "inputs",
+    "template_family",
+    "stages",
+    "decisions",
+    "evidence",
+    "blockers",
+    "warnings",
+    "next"
+  ],
+  "properties": {
+    "schema_version": { "const": "campaign-runtime-assembly-report/v0" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "generated_at": { "type": "string", "minLength": 1 },
+    "status": { "type": "string", "minLength": 1 },
+    "identity": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["map_id", "public_route_slug", "campaign_directory", "live_url_path", "spec_hash"],
+      "properties": {
+        "map_id": { "type": "string", "minLength": 1 },
+        "public_route_slug": { "type": "string", "minLength": 1 },
+        "campaign_directory": { "type": "string", "minLength": 1 },
+        "live_url_path": { "type": "string", "minLength": 1 },
+        "spec_hash": { "type": "string", "minLength": 1 },
+        "spec_material_hash": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$",
+          "description": "Canonical semantic identity used to correlate QA with the authored spec. spec_hash remains exact raw-byte integrity."
+        }
+      }
+    },
+    "inputs": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["packet_path", "context_path", "spec_path", "source", "target_repo"],
+      "properties": {
+        "packet_path": { "type": "string", "minLength": 1 },
+        "context_path": { "type": "string", "minLength": 1 },
+        "spec_path": { "type": "string", "minLength": 1 },
+        "source": {
+          "type": "object",
+          "required": ["kind", "root"],
+          "properties": {
+            "kind": { "enum": ["html_funnel", "figma_sections", "figma_freeform"] },
+            "root": { "type": "string", "minLength": 1 }
+          }
+        },
+        "target_repo": { "type": "string", "minLength": 1 }
+      }
+    },
+    "template_family": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["value", "locked"],
+      "properties": {
+        "value": { "type": "string", "minLength": 1 },
+        "locked": { "type": "boolean" },
+        "locked_by": { "type": ["string", "null"] },
+        "commerce_catalog_version": { "type": ["string", "null"] },
+        "candidates": { "type": "array" }
+      }
+    },
+    "stages": {
+      "type": "object",
+      "required": ["prepare_build", "doctor", "setup", "assembly", "polish", "deploy", "qa"],
+      "properties": {
+        "prepare_build": { "$ref": "#/$defs/stage" },
+        "doctor": { "$ref": "#/$defs/stage" },
+        "setup": { "$ref": "#/$defs/stage" },
+        "assembly": { "$ref": "#/$defs/stage" },
+        "polish": { "$ref": "#/$defs/stage" },
+        "deploy": { "$ref": "#/$defs/stage" },
+        "qa": { "$ref": "#/$defs/stage" }
+      }
+    },
+    "checklists": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "polish": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "anchor_screenshots": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/evidenceCheck" }
+            },
+            "state_screenshots": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/evidenceCheck" }
+            },
+            "runtime_smoke": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/evidenceCheck" }
+            }
+          }
+        },
+        "template_family": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["family", "invariants"],
+          "properties": {
+            "family": { "type": "string", "minLength": 1 },
+            "invariants": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/invariant" }
+            }
+          }
+        }
+      }
+    },
+    "decisions": { "type": "array" },
+    "build_brief": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["schema_version", "mode", "status", "normalized_path", "question_count", "gate_count"],
+      "properties": {
+        "schema_version": { "const": "campaigns-os-build-brief/v1" },
+        "mode": { "enum": ["prepared", "guided_draft"] },
+        "status": { "enum": ["complete", "needs_answers", "invalid"] },
+        "normalized_path": { "type": "string", "minLength": 1 },
+        "question_count": { "type": "integer", "minimum": 0 },
+        "gate_count": { "type": "integer", "minimum": 0 }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "status": { "const": "needs_answers" } },
+            "required": ["status"]
+          },
+          "then": {
+            "anyOf": [
+              {
+                "properties": {
+                  "question_count": { "type": "integer", "minimum": 1 }
+                }
+              },
+              {
+                "properties": {
+                  "gate_count": { "type": "integer", "minimum": 1 }
+                }
+              }
+            ]
+          }
+        }
+      ],
+      "description": "Campaign Build Brief summary mirrored from Build Context for build/polish/QA handoff continuity."
+    },
+    "design_source_package": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "schema_version": { "const": "campaign-design-source-package/v0" },
+        "sha256": { "type": "string", "minLength": 1 },
+        "material_fingerprint": { "type": "string", "minLength": 1 }
+      },
+      "description": "Reference to the normalized Design Source Package used by Build and Polish. sha256 is the full artifact hash; material_fingerprint drives freshness gates."
+    },
+    "adapter_decisions": { "$ref": "#/$defs/adapterDecisions" },
+    "proof_policy": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "browser_qa_required": { "type": "boolean" },
+        "typed_card_depth": { "type": "string", "minLength": 1 },
+        "localhost_development_domain_allowed": { "type": "boolean" },
+        "non_localhost_origin_allowlist_required": { "type": "boolean" },
+        "order_path_depth": { "type": "string", "minLength": 1 },
+        "operator_approval_state": { "type": "string", "minLength": 1 },
+        "qa_portal_publish_default": { "type": "boolean" }
+      }
+    },
+    "waivers": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/checkpointWaiver" },
+      "description": "Structured readiness exceptions approved by an operator/run decision. Stages may recommend waivers, but accepted waivers must be explicit and attributed."
+    },
+    "theme": {
+      "type": ["object", "null"],
+      "additionalProperties": true,
+      "properties": {
+        "status": { "enum": ["applied", "skipped", "blocked", "needs_review"] },
+        "css_path": { "type": ["string", "null"] },
+        "load_order": { "enum": ["after-next-core", "not-applied", "unknown"] },
+        "commerce_pages": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "warnings": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/themeIssue" }
+        },
+        "repair_loop_defect": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/themeIssue" }
+          ]
+        },
+        "waiver": {
+          "description": "Explicit operator waiver of the theme gate (ship commerce pages without the generatable brand layer), with a recorded reason. Written by `campaigns-os theme waive`.",
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "additionalProperties": true,
+              "required": ["reason"],
+              "properties": {
+                "reason": { "type": "string", "minLength": 1 },
+                "waived_by": { "type": ["string", "null"] },
+                "waived_at": { "type": ["string", "null"] }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "evidence": { "type": "array" },
+    "blockers": { "type": "array" },
+    "warnings": { "type": "array" },
+    "next": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["stage", "owner", "action"],
+      "properties": {
+        "stage": { "type": "string", "minLength": 1 },
+        "owner": { "type": "string", "minLength": 1 },
+        "action": { "type": "string", "minLength": 1 },
+        "blocked_stages": { "type": "array" }
+      }
+    }
+  },
+  "$defs": {
+    "checkpointWaiver": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["scope", "reason"],
+      "properties": {
+        "scope": { "type": "string", "minLength": 1 },
+        "reason": { "type": "string", "minLength": 1 },
+        "applies_to": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "waived_by": { "type": ["string", "null"] },
+        "owner": { "type": ["string", "null"] },
+        "waived_at": { "type": ["string", "null"] },
+        "created_at": { "type": ["string", "null"] },
+        "expires_at": {
+          "type": ["string", "null"],
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
+          "description": "ISO 8601 date or date-time — a deliberate canonical subset: date, or date-time with optional Z/±HH:MM offset. Exotic Date.parse-accepted forms (date-only with a timezone, hour-only offsets) are rejected here even though the runtime tolerates them. The pattern is syntactic only: calendar-invalid values (e.g. month 13) can pass the schema and are still rejected at runtime. The polish gate parses this value: an unparseable string blocks with polish.waiver_expires_at_invalid, and an expiry at or before the evaluation instant (inclusive boundary) means the waiver is not honored."
+        },
+        "review_condition": { "type": ["string", "null"] },
+        "evidence_refs": { "type": "array" }
+      }
+    },
+    "adapterDecisions": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "raw_html_conversion_status",
+        "source_asset_strategy",
+        "commerce_shell_adoption",
+        "route_rewrite_policy",
+        "template_files_copied",
+        "config_script_strategy",
+        "wrapper_policy",
+        "frontmatter_policy",
+        "script_style_reference_policy",
+        "cta_rewrite_policy",
+        "layout_choice"
+      ],
+      "properties": {
+        "raw_html_conversion_status": { "enum": ["pending", "in_progress", "completed", "not_required", "blocked"] },
+        "source_asset_strategy": { "enum": ["pagekit_campaign_asset_root", "external_cdn", "raw_passthrough", "not_applicable", "unknown"] },
+        "commerce_shell_adoption": { "enum": ["not_required", "template_clone_first_required", "template_clone_first_verified", "sdk_surfaces_preserved", "custom_html_experimental"] },
+        "route_rewrite_policy": { "enum": ["campaignspec_routes_via_campaign_link", "pagekit_public_routes", "raw_passthrough", "not_applicable", "unknown"] },
+        "config_script_strategy": { "enum": ["campaign_asset", "frontmatter_script", "inline", "not_required", "unknown"] },
+        "wrapper_policy": { "enum": ["strip_document_wrappers", "preserve_document_wrappers", "not_required", "unknown"] },
+        "frontmatter_policy": { "enum": ["pagekit_yaml_frontmatter", "raw_passthrough", "not_required", "unknown"] },
+        "script_style_reference_policy": { "enum": ["frontmatter_or_campaign_asset", "frontmatter", "campaign_asset", "inline", "raw_passthrough", "not_required", "unknown"] },
+        "cta_rewrite_policy": { "enum": ["campaignspec_routes_via_campaign_link", "pagekit_public_routes", "raw_passthrough", "not_applicable", "unknown"] },
+        "layout_choice": { "enum": ["campaign_layout", "page_layout", "raw_passthrough", "not_applicable", "unknown"] },
+        "template_files_copied": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["status", "required_groups", "groups", "paths"],
+          "properties": {
+            "status": { "enum": ["pending", "complete", "verified_existing_slice", "partial", "not_applicable"] },
+            "required_groups": { "type": "array", "items": { "type": "string" } },
+            "groups": { "type": "array", "items": { "type": "string" } },
+            "paths": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+    "stage": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["stage", "status"],
+      "properties": {
+        "stage": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "required_by": { "type": "string", "minLength": 1 },
+        "required_for": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "performed_by": { "type": "string", "minLength": 1 },
+        "source_build_fingerprint": { "type": "string", "minLength": 1 },
+        "source_package_material_fingerprint": { "type": "string", "minLength": 1 },
+        "build_fingerprint": { "type": "string", "minLength": 1 },
+        "artifact_fingerprint": { "type": "string", "minLength": 1 },
+        "completed_at": { "type": "string", "minLength": 1 },
+        "evidence": {
+          "description": "Stage-owned structured evidence. For stages.polish, this must include visual_review, brand_review, checkout_review, template_residue_review, commerce_flow_review, issues, and commands before QA.",
+          "oneOf": [
+            { "type": "array" },
+            { "type": "object", "additionalProperties": true }
+          ]
+        },
+        "inputs": { "type": "array", "default": [] },
+        "outputs": { "type": "array", "default": [] },
+        "commands": { "type": "array", "default": [] },
+        "blockers": { "type": "array", "default": [] },
+        "warnings": { "type": "array", "default": [] }
+      }
+    },
+    "evidenceCheck": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["page_type", "evidence"],
+      "properties": {
+        "page_type": { "type": "string", "minLength": 1 },
+        "anchor": { "type": "string" },
+        "state": { "type": "string" },
+        "viewports": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "status": { "type": "string" }
+      }
+    },
+    "invariant": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "status", "evidence"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["passed", "failed", "blocked", "skipped"] },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "notes": { "type": ["string", "null"] }
+      }
+    },
+    "themeIssue": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 },
+        "detail": { "type": "object", "additionalProperties": true }
+      }
+    }
+  }
+}