@storewright/cli 0.14.0

package/schemas/shopify-operation-request.schema.json

@@ -0,0 +1,81 @@
+{
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "stageId",
+    "attemptId",
+    "actionId",
+    "launchEnvelopeSha256",
+    "grantedScopes",
+    "operationKey",
+    "targetStore",
+    "apiVersion",
+    "requestFingerprint",
+    "naturalResourceKey",
+    "providerIdempotencySupported",
+    "resourceType",
+    "executorInput"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "runDir": { "type": "string", "minLength": 1 },
+    "stageId": { "type": "string", "minLength": 1 },
+    "attemptId": { "type": "string", "minLength": 1 },
+    "launchEnvelopePath": { "type": "string", "minLength": 1 },
+    "envelope": { "type": "object" },
+    "actionId": { "type": "string", "minLength": 1 },
+    "launchEnvelopeSha256": { "type": "string", "minLength": 1 },
+    "grantedScopes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "approvalGrantPath": {
+      "anyOf": [
+        { "type": "string", "minLength": 1 },
+        { "const": null }
+      ]
+    },
+    "operationKey": { "type": "string", "minLength": 1 },
+    "targetStore": { "type": "string", "minLength": 1 },
+    "apiVersion": { "type": "string", "minLength": 1 },
+    "requestFingerprint": { "type": "string", "minLength": 1 },
+    "naturalResourceKey": { "type": "string", "minLength": 1 },
+    "providerIdempotencySupported": { "type": "boolean" },
+    "resourceType": { "type": "string", "minLength": 1 },
+    "executorInput": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["kind", "operationName", "query"],
+          "properties": {
+            "kind": { "const": "admin-graphql" },
+            "operationName": { "type": "string", "minLength": 1 },
+            "query": { "type": "string", "minLength": 1 },
+            "variables": { "type": "object" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["kind", "themeWorkspace"],
+          "properties": {
+            "kind": { "const": "theme-push-unpublished" },
+            "themeWorkspace": { "type": "string", "minLength": 1 },
+            "themeId": { "type": "string", "minLength": 1 },
+            "themeName": { "type": "string", "minLength": 1 },
+            "nodelete": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "anyOf": [
+    { "required": ["launchEnvelopePath"] },
+    { "required": ["envelope"] }
+  ],
+  "not": {
+    "required": ["actionRegistry"]
+  },
+  "additionalProperties": false
+}

package/schemas/shopify-preflight-report.schema.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/shopify-preflight-report.schema.json",
+  "title": "Storewright Shopify Preflight Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "preflight"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0.0" },
+    "runId": { "type": "string", "minLength": 1 },
+    "preflight": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["store", "shopifyCli", "storeAccess", "adminGraphqlAccess", "requiredManualApprovals", "publicationStrategy", "commands"],
+      "properties": {
+        "store": { "type": "string", "minLength": 1 },
+        "shopifyCli": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["result", "version"],
+          "properties": {
+            "result": { "type": "string", "enum": ["ok", "error"] },
+            "version": { "type": "string" },
+            "details": { "type": "string" }
+          }
+        },
+        "storeAccess": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["result", "details"],
+          "properties": {
+            "result": { "type": "string", "enum": ["ok", "error"] },
+            "details": { "type": "string" }
+          }
+        },
+        "adminGraphqlAccess": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["result", "details"],
+          "properties": {
+            "result": { "type": "string", "enum": ["ok", "error"] },
+            "details": { "type": "string" }
+          }
+        },
+        "requiredManualApprovals": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "scopeMatrix": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["operation", "scopes", "source"],
+            "properties": {
+              "operation": { "type": "string", "minLength": 1 },
+              "scopes": {
+                "type": "array",
+                "items": { "type": "string", "minLength": 1 }
+              },
+              "source": { "type": "string", "minLength": 1 },
+              "reason": { "type": "string" }
+            }
+          }
+        },
+        "requiredScopes": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "publicationStrategy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["productStatus", "publicationChannel", "publicationLookup", "requiredScopes"],
+          "anyOf": [
+            {
+              "type": "object",
+              "required": ["publicationId", "publicationName", "missingOrZeroPriceStrategy", "verificationFields"],
+              "properties": {
+                "publicationLookup": {
+                  "type": "object",
+                  "required": ["matchedPublication"],
+                  "properties": {
+                    "result": { "type": "string", "const": "ok" }
+                  }
+                }
+              }
+            },
+            {
+              "type": "object",
+              "properties": {
+                "publicationLookup": {
+                  "type": "object",
+                  "required": ["blockerId"],
+                  "properties": {
+                    "result": { "type": "string", "enum": ["missing", "ambiguous", "error"] }
+                  }
+                }
+              }
+            }
+          ],
+          "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", "selectionReason"],
+              "properties": {
+                "result": { "type": "string", "enum": ["ok", "missing", "ambiguous", "error"] },
+                "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" }
+                  }
+                },
+                "blockerId": { "type": "string", "minLength": 1 },
+                "errorSummary": { "type": "string" },
+                "selectionReason": { "type": "string", "minLength": 1 }
+              }
+            },
+            "missingOrZeroPriceStrategy": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["match", "productStatus", "publicationChannel", "requiredScopes", "verificationFields"],
+              "properties": {
+                "match": { "type": "string", "const": "missing-or-zero-price" },
+                "productStatus": { "type": "string", "const": "DRAFT" },
+                "publicationChannel": { "type": "string", "const": "Online Store" },
+                "requiredScopes": {
+                  "type": "array",
+                  "items": { "type": "string", "minLength": 1 },
+                  "minItems": 2,
+                  "allOf": [
+                    { "contains": { "const": "read_publications" } },
+                    { "contains": { "const": "write_publications" } }
+                  ]
+                },
+                "verificationFields": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["resourcePublications", "publishedOnPublication"]
+                  },
+                  "minItems": 1
+                }
+              }
+            },
+            "requiredScopes": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 },
+              "minItems": 2,
+              "allOf": [
+                { "contains": { "const": "read_publications" } },
+                { "contains": { "const": "write_publications" } }
+              ]
+            },
+            "verificationFields": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["resourcePublications", "publishedOnPublication", "onlineStoreUrl"]
+              },
+              "minItems": 1
+            }
+          }
+        },
+        "commands": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["themeList", "adminGraphqlRead"],
+          "properties": {
+            "themeList": { "type": "string", "minLength": 1 },
+            "adminGraphqlRead": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/store-blueprint.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/store-blueprint.schema.json",
+  "title": "Storewright Store Blueprint",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "authoring", "storeBlueprint"],
+  "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": "agent-authored" },
+        "createdBy": { "type": "string", "minLength": 1 },
+        "sourceInputArtifacts": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "storeBlueprint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sitemap", "collections", "navigation", "homepage", "contentPages", "seo"],
+      "properties": {
+        "sitemap": { "type": "array", "items": { "type": "string" } },
+        "collections": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["handle", "title", "productIds"],
+            "properties": {
+              "handle": { "type": "string", "minLength": 1 },
+              "title": { "type": "string", "minLength": 1 },
+              "description": { "type": "string" },
+              "productIds": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "navigation": { "type": "array", "items": { "type": "string" } },
+        "homepage": { "type": "array", "items": { "type": "string" } },
+        "contentPages": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["handle", "sourceContent", "placement", "required"],
+            "properties": {
+              "handle": { "type": "string", "minLength": 1 },
+              "sourceContent": {
+                "type": "string",
+                "enum": ["storeContent.brandStory", "storeContent.pageBodies"]
+              },
+              "placement": {
+                "type": "string",
+                "enum": ["standalone-page", "homepage-section", "footer-navigation"]
+              },
+              "required": { "type": "boolean" },
+              "fallbackReason": { "type": "string" }
+            }
+          }
+        },
+        "mediaRequirements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "slotId",
+              "usage",
+              "assetKind",
+              "placement",
+              "aspectRatio",
+              "altText",
+              "sourceRationale"
+            ],
+            "properties": {
+              "slotId": { "type": "string", "minLength": 1 },
+              "usage": { "type": "string", "minLength": 1 },
+              "assetKind": {
+                "type": "string",
+                "enum": ["product-derived", "generated", "supplied", "shopify-existing"]
+              },
+              "placement": { "type": "string", "minLength": 1 },
+              "aspectRatio": { "type": "string", "minLength": 1 },
+              "altText": { "type": "string", "minLength": 1 },
+              "sourceRationale": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "pages": { "type": "array", "items": { "type": "string" } },
+        "seo": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["title", "description"],
+          "properties": {
+            "title": { "type": "string", "minLength": 1 },
+            "description": { "type": "string", "minLength": 1 }
+          }
+        },
+        "brandVoice": { "type": "string" },
+        "visualTokens": { "type": "object" }
+      }
+    }
+  }
+}

package/schemas/store-content-generation-output.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/store-content-generation-output.schema.json",
+  "title": "Storewright Store Content Generation Output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "authoring", "storeContent"],
+  "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": "agent-authored" },
+        "createdBy": { "type": "string", "minLength": 1 },
+        "sourceInputArtifacts": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "storeContent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["homepageCopy", "collectionDescriptions", "pageBodies", "brandStory"],
+      "properties": {
+        "homepageCopy": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "collectionDescriptions": {
+          "type": "array",
+          "items": { "type": "object" }
+        },
+        "pageBodies": {
+          "type": "array",
+          "items": { "type": "object" }
+        },
+        "brandStory": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "pageHandle",
+            "storyMode",
+            "title",
+            "seo",
+            "sections",
+            "factClaims",
+            "agentInferences",
+            "claimsNeedingReview"
+          ],
+          "properties": {
+            "pageHandle": { "type": "string", "const": "our-story" },
+            "storyMode": {
+              "type": "string",
+              "enum": ["founder-story", "curation-story", "point-of-view"]
+            },
+            "title": { "type": "string", "minLength": 1 },
+            "seo": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["title", "description"],
+              "properties": {
+                "title": { "type": "string", "minLength": 1 },
+                "description": { "type": "string", "minLength": 1 }
+              }
+            },
+            "sections": {
+              "type": "array",
+              "minItems": 4,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["heading", "body", "role"],
+                "properties": {
+                  "heading": { "type": "string", "minLength": 1 },
+                  "body": { "type": "string", "minLength": 1 },
+                  "role": { "type": "string", "minLength": 1 }
+                }
+              }
+            },
+            "factClaims": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "agentInferences": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "claimsNeedingReview": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}