@storewright/cli 0.14.0

package/schemas/store-intake.schema.json

@@ -0,0 +1,205 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/store-intake.schema.json",
+  "title": "Official Store Intake",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "storeIntake"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "storeIntake": {
+      "type": "object",
+      "required": [
+        "category",
+        "market",
+        "currency",
+        "competitors",
+        "fieldStatuses",
+        "brandName",
+        "targetAudience",
+        "productCandidateUrls",
+        "productCandidateFiles",
+        "intakeRequirements",
+        "intakeReview"
+      ],
+      "properties": {
+        "store": { "type": "string" },
+        "category": { "type": "string" },
+        "market": { "type": "string" },
+        "currency": { "type": "string" },
+        "fieldStatuses": {
+          "type": "object",
+          "required": ["category", "market", "currency", "competitors", "store", "productCandidates"],
+          "properties": {
+            "category": { "$ref": "#/$defs/fieldStatus" },
+            "market": { "$ref": "#/$defs/fieldStatus" },
+            "currency": { "$ref": "#/$defs/fieldStatus" },
+            "competitors": {
+              "type": "object",
+              "required": ["status", "count"],
+              "properties": {
+                "status": { "type": "string" },
+                "count": { "type": "number" }
+              }
+            },
+            "store": { "$ref": "#/$defs/fieldStatus" },
+            "productCandidates": { "$ref": "#/$defs/fieldStatus" }
+          }
+        },
+        "brandName": {
+          "type": "object",
+          "required": ["value", "status"],
+          "properties": {
+            "value": { "type": "string" },
+            "status": { "type": "string" }
+          }
+        },
+        "competitors": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "targetAudience": {
+          "type": "object",
+          "required": ["value", "status"],
+          "properties": {
+            "value": { "type": "string" },
+            "status": { "type": "string" },
+            "evidence": { "type": "string" }
+          }
+        },
+        "productCandidateUrls": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "productCandidateFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "brandFacts": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "founderOrTeam": { "type": "string" },
+            "location": { "type": "string" },
+            "year": { "type": "string" },
+            "originStory": { "type": "string" },
+            "provenClaims": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "forbiddenClaims": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "unknownClaims": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "intakeRequirements": {
+          "type": "object",
+          "required": [
+            "stageHardRequired",
+            "requiredBeforeProductExecution",
+            "requiredBeforeShopifyWrite",
+            "optionalOrInferable",
+            "missingStageHardRequired",
+            "missingBeforeProductExecution",
+            "missingBeforeShopifyWrite",
+            "missingOptionalOrInferable"
+          ],
+          "properties": {
+            "stageHardRequired": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "requiredBeforeProductExecution": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "requiredBeforeShopifyWrite": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "optionalOrInferable": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "missingStageHardRequired": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "missingBeforeProductExecution": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "missingBeforeShopifyWrite": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "missingOptionalOrInferable": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "intakeReview": {
+          "type": "object",
+          "required": [
+            "recognizedFields",
+            "missingRequiredFields",
+            "optionalClarificationItems",
+            "leadPromptRecommendation"
+          ],
+          "properties": {
+            "recognizedFields": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/intakeReviewField" }
+            },
+            "missingRequiredFields": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "optionalClarificationItems": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["field", "status", "prompt", "skipBehavior"],
+                "properties": {
+                  "field": { "type": "string" },
+                  "status": { "type": "string" },
+                  "prompt": { "type": "string" },
+                  "skipBehavior": { "type": "string" }
+                }
+              }
+            },
+            "leadPromptRecommendation": {
+              "type": "string",
+              "enum": ["blocked-required", "nonblocking-optional", "none"]
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "fieldStatus": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": { "type": "string" },
+        "evidence": { "type": "string" }
+      }
+    },
+    "intakeReviewField": {
+      "type": "object",
+      "required": ["field", "status", "evidence"],
+      "properties": {
+        "field": { "type": "string" },
+        "status": { "type": "string" },
+        "evidence": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/store-ops-plan.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/store-ops-plan.schema.json",
+  "title": "Store Ops Plan",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "storeOpsPlan"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "storeOpsPlan": {
+      "type": "object",
+      "required": ["operations", "defaultProductStatus", "defaultPublicationChannel", "publicationStrategy"],
+      "properties": {
+        "operations": { "type": "array" },
+        "defaultProductStatus": { "type": "string", "const": "ACTIVE" },
+        "defaultPublicationChannel": { "type": "string", "const": "Online Store" },
+        "publicationStrategy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["productStatus", "publicationChannel", "publicationId", "publicationName", "publicationLookup", "missingOrZeroPriceStrategy", "mutation", "verificationFields"],
+          "properties": {
+            "productStatus": { "type": "string", "const": "ACTIVE" },
+            "publicationChannel": { "type": "string", "const": "Online Store" },
+            "publicationId": { "type": "string", "pattern": "^gid://shopify/Publication/" },
+            "publicationName": { "type": "string", "const": "Online Store" },
+            "publicationLookup": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["result", "command", "rawOutputPath", "matchedPublication", "selectionReason"],
+              "properties": {
+                "result": { "type": "string", "const": "ok" },
+                "command": { "type": "string", "minLength": 1 },
+                "rawOutputPath": { "type": "string", "minLength": 1 },
+                "candidateCount": { "type": "number" },
+                "matchedPublication": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["id", "name"],
+                  "properties": {
+                    "id": { "type": "string", "pattern": "^gid://shopify/Publication/" },
+                    "name": { "type": "string", "const": "Online Store" }
+                  }
+                },
+                "selectionReason": { "type": "string", "minLength": 1 }
+              }
+            },
+            "missingOrZeroPriceStrategy": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["match", "productStatus", "publicationChannel", "mutation", "verificationFields"],
+              "properties": {
+                "match": { "type": "string", "const": "missing-or-zero-price" },
+                "productStatus": { "type": "string", "const": "DRAFT" },
+                "publicationChannel": { "type": "string", "const": "Online Store" },
+                "mutation": { "type": "string", "const": "publishablePublish" },
+                "verificationFields": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["resourcePublications", "publishedOnPublication"]
+                  },
+                  "minItems": 1
+                }
+              }
+            },
+            "mutation": { "type": "string", "const": "publishablePublish" },
+            "verificationFields": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["resourcePublications", "publishedOnPublication", "onlineStoreUrl"]
+              },
+              "minItems": 1
+            }
+          }
+        },
+        "notReadyResources": { "type": "array" },
+        "notes": { "type": "array" }
+      }
+    }
+  }
+}

package/schemas/storefront-preview-review.schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/storefront-preview-review.schema.json",
+  "title": "Storewright Storefront Preview Acceptance Review",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "authoring", "storefrontPreviewReview"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0.0" },
+    "runId": { "type": "string", "minLength": 1 },
+    "authoring": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "createdBy", "sourceInputArtifacts"],
+      "properties": {
+        "mode": { "type": "string", "const": "worker-authored" },
+        "createdBy": { "type": "string", "minLength": 1 },
+        "sourceInputArtifacts": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "storefrontPreviewReview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "result",
+        "reviewTarget",
+        "intakeContext",
+        "journeys",
+        "findings",
+        "repairRequests",
+        "humanAcceptanceSummary"
+      ],
+      "properties": {
+        "result": { "type": "string", "enum": ["pass", "warning", "repairable", "blocked", "fatal"] },
+        "reviewTarget": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["storeDomain", "previewThemeId", "previewUrl", "accessResult", "passwordProvided", "passwordValueRecorded"],
+          "properties": {
+            "storeDomain": { "type": "string", "minLength": 1 },
+            "previewThemeId": { "type": "string", "minLength": 1 },
+            "previewUrl": { "type": "string", "minLength": 1 },
+            "accessResult": { "type": "string", "enum": ["success", "warning", "failed", "blocked"] },
+            "passwordProvided": { "type": "boolean" },
+            "passwordValueRecorded": { "type": "boolean" }
+          }
+        },
+        "intakeContext": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["category", "market", "currency", "goalSummary"],
+          "properties": {
+            "brand": { "type": "string" },
+            "category": { "type": "string", "minLength": 1 },
+            "market": { "type": "string", "minLength": 1 },
+            "currency": { "type": "string", "minLength": 1 },
+            "goalSummary": { "type": "string", "minLength": 1 }
+          }
+        },
+        "journeys": {
+          "type": "array",
+          "minItems": 8,
+          "allOf": [
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "home" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "navigation" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "collection-product-browsing" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "product-detail" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "cart-smoke" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "content-support-pages" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "mobile-layout" } } } },
+            { "contains": { "type": "object", "required": ["name"], "properties": { "name": { "const": "desktop-layout" } } } }
+          ],
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "status", "evidenceRefs"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "enum": [
+                  "home",
+                  "navigation",
+                  "collection-product-browsing",
+                  "product-detail",
+                  "cart-smoke",
+                  "content-support-pages",
+                  "mobile-layout",
+                  "desktop-layout"
+                ]
+              },
+              "status": { "type": "string", "enum": ["pass", "warning", "fail", "blocked", "not-tested"] },
+              "evidenceRefs": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 }
+              }
+            }
+          }
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "severity", "category", "humanImpact", "evidenceRefs"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "severity": { "type": "string", "enum": ["P0", "P1", "P2", "P3"] },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "page-unavailable",
+                  "broken-navigation",
+                  "layout-breakage",
+                  "missing-content",
+                  "broken-commerce",
+                  "brand-mismatch",
+                  "placeholder-content",
+                  "visual-defect",
+                  "preview-access"
+                ]
+              },
+              "humanImpact": { "type": "string", "minLength": 1 },
+              "route": { "type": "string" },
+              "viewport": { "type": "string", "enum": ["desktop", "mobile", "not-applicable"] },
+              "evidenceRefs": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 }
+              }
+            }
+          }
+        },
+        "repairRequests": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "findingIds",
+              "category",
+              "humanImpact",
+              "evidenceRefs",
+              "recommendedTargetWorkerProfile",
+              "requiredOutcome"
+            ],
+            "anyOf": [
+              {
+                "type": "object",
+                "required": ["category", "recommendedTargetWorkerProfile"],
+                "properties": {
+                  "category": { "type": "string", "enum": ["layout-breakage", "visual-defect", "placeholder-content", "brand-mismatch"] },
+                  "recommendedTargetWorkerProfile": { "type": "string", "const": "theme-build-worker" }
+                }
+              },
+              {
+                "type": "object",
+                "required": ["category", "recommendedTargetWorkerProfile"],
+                "properties": {
+                  "category": { "type": "string", "enum": ["broken-navigation", "missing-content", "page-unavailable"] },
+                  "recommendedTargetWorkerProfile": { "type": "string", "const": "store-ops-content-worker" }
+                }
+              },
+              {
+                "type": "object",
+                "required": ["category", "recommendedTargetWorkerProfile"],
+                "properties": {
+                  "category": { "type": "string", "const": "broken-commerce" },
+                  "recommendedTargetWorkerProfile": { "type": "string", "const": "store-ops-products-worker" }
+                }
+              },
+              {
+                "type": "object",
+                "required": ["category", "recommendedTargetWorkerProfile"],
+                "properties": {
+                  "category": { "type": "string", "const": "preview-access" },
+                  "recommendedTargetWorkerProfile": { "type": "string", "const": "store-ops-theme-worker" }
+                }
+              }
+            ],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "findingIds": {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": "string", "minLength": 1 }
+              },
+              "category": {
+                "type": "string",
+                "enum": [
+                  "page-unavailable",
+                  "broken-navigation",
+                  "layout-breakage",
+                  "missing-content",
+                  "broken-commerce",
+                  "brand-mismatch",
+                  "placeholder-content",
+                  "visual-defect",
+                  "preview-access"
+                ]
+              },
+              "humanImpact": { "type": "string", "minLength": 1 },
+              "evidenceRefs": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 }
+              },
+              "recommendedTargetWorkerProfile": {
+                "type": "string",
+                "enum": [
+                  "theme-build-worker",
+                  "store-ops-content-worker",
+                  "store-ops-products-worker",
+                  "store-ops-theme-worker"
+                ]
+              },
+              "requiredOutcome": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "humanAcceptanceSummary": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/schemas/supplier-access-report.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "supplier-access-report.schema.json",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "supplierAccess"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "supplierAccess": {
+      "type": "object",
+      "required": ["checkedCandidateId", "checkedUrl"],
+      "properties": {
+        "checkedCandidateId": { "type": "string" },
+        "checkedUrl": { "type": "string" },
+        "url": { "type": "string" },
+        "finalUrl": { "type": "string" },
+        "httpStatus": { "type": ["number", "null"] },
+        "pageState": { "type": "string" },
+        "evidenceStatus": { "type": "string" },
+        "titleText": { "type": "string" },
+        "selectorFindings": {
+          "type": "array",
+          "items": { "type": "object" }
+        },
+        "errorCode": { "type": "string" },
+        "errorMessage": { "type": "string" },
+        "warningMessages": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}