npm - @storewright/cli - Versions diffs - 0.14.0 - Mend

@storewright/cli 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

package/README.md +19 -0
package/VERSION +1 -0
package/bin/storewright.mjs +62 -0
package/contracts/action-registry.json +175 -0
package/contracts/capability-registry.json +63 -0
package/contracts/workflow-manifest.json +207 -0
package/lib/cli/storewright-cli.mjs +259 -0
package/lib/internal/launch-envelope.mjs +223 -0
package/lib/internal/multi-agent-contracts.mjs +137 -0
package/lib/internal/operation-ledger.mjs +190 -0
package/lib/internal/pricing/default-preview-pricing.mjs +181 -0
package/lib/internal/run-state-helpers.mjs +313 -0
package/lib/internal/shopify-operation-adapter.mjs +456 -0
package/package.json +38 -0
package/schemas/action-registry.schema.json +11 -0
package/schemas/agent-report.schema.json +14 -0
package/schemas/approval-grant.schema.json +16 -0
package/schemas/base-theme-report.schema.json +25 -0
package/schemas/brand-identity.schema.json +142 -0
package/schemas/capability-registry.schema.json +11 -0
package/schemas/competitor-audit.schema.json +38 -0
package/schemas/design-direction.schema.json +64 -0
package/schemas/external-operation.schema.json +34 -0
package/schemas/intake-blocked-report.schema.json +76 -0
package/schemas/launch-envelope.schema.json +25 -0
package/schemas/launch-readiness.schema.json +73 -0
package/schemas/media-file-inspection-report.schema.json +223 -0
package/schemas/media-manifest.schema.json +84 -0
package/schemas/merchandising-brief.schema.json +27 -0
package/schemas/normalized-product-catalog.schema.json +42 -0
package/schemas/product-content-generation-input.schema.json +40 -0
package/schemas/product-content-generation-output.schema.json +43 -0
package/schemas/raw-product-candidates.schema.json +32 -0
package/schemas/shopify-access-preflight-report.schema.json +213 -0
package/schemas/shopify-content-sync-report.schema.json +190 -0
package/schemas/shopify-media-map.schema.json +87 -0
package/schemas/shopify-media-upload-report.schema.json +96 -0
package/schemas/shopify-operation-request.schema.json +81 -0
package/schemas/shopify-preflight-report.schema.json +187 -0
package/schemas/store-blueprint.schema.json +112 -0
package/schemas/store-content-generation-output.schema.json +102 -0
package/schemas/store-intake.schema.json +205 -0
package/schemas/store-ops-plan.schema.json +82 -0
package/schemas/storefront-preview-review.schema.json +227 -0
package/schemas/supplier-access-report.schema.json +36 -0
package/schemas/supplier-extraction-report.schema.json +185 -0
package/schemas/theme-build-report.schema.json +43 -0
package/schemas/theme-code-change-summary.schema.json +65 -0
package/schemas/theme-plan.schema.json +26 -0
package/schemas/theme-push-report.schema.json +151 -0
package/schemas/theme-workspace-validation-report.schema.json +61 -0
package/schemas/workflow-manifest.schema.json +29 -0
package/scripts/audit-run-state.mjs +472 -0
package/scripts/execute-shopify-operation.mjs +190 -0
package/scripts/generate-image-assets-openai.mjs +342 -0
package/scripts/generate-media-assets.mjs +121 -0
package/scripts/init-run-state.mjs +69 -0
package/scripts/inspect-media-files.mjs +334 -0
package/scripts/prepare-launch-envelope.mjs +47 -0
package/scripts/shopify-access-preflight.mjs +432 -0
package/scripts/upload-shopify-media.mjs +831 -0
package/scripts/validate-agent-report.mjs +46 -0
package/scripts/validate-artifact.mjs +196 -0
package/scripts/validate-launch-envelope.mjs +50 -0
package/scripts/validate-registries.mjs +50 -0
package/scripts/validate-workflow-manifest.mjs +38 -0
package/scripts/version.mjs +192 -0

package/schemas/media-file-inspection-report.schema.json ADDED Viewed

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/media-file-inspection-report.schema.json",
+  "title": "Storewright Media File Inspection Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "runId",
+    "authoring",
+    "mediaFileInspection"
+  ],
+  "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
+          }
+        }
+      }
+    },
+    "mediaFileInspection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "dimensionThreshold",
+        "summary",
+        "duplicateHashGroups",
+        "assets"
+      ],
+      "properties": {
+        "dimensionThreshold": {
+          "type": "number",
+          "minimum": 1
+        },
+        "summary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "assetCount",
+            "missingFileCount",
+            "duplicateHashGroupCount",
+            "findingCount"
+          ],
+          "properties": {
+            "assetCount": {
+              "type": "number",
+              "minimum": 0
+            },
+            "missingFileCount": {
+              "type": "number",
+              "minimum": 0
+            },
+            "duplicateHashGroupCount": {
+              "type": "number",
+              "minimum": 0
+            },
+            "findingCount": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        },
+        "duplicateHashGroups": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "groupId",
+              "sha256",
+              "assetRefs",
+              "candidateIds"
+            ],
+            "properties": {
+              "groupId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "sha256": {
+                "type": "string",
+                "minLength": 64
+              },
+              "assetRefs": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "candidateIds": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          }
+        },
+        "assets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "assetRef",
+              "localPath",
+              "fileExists",
+              "findingCodes",
+              "findings"
+            ],
+            "properties": {
+              "assetRef": {
+                "type": "string",
+                "minLength": 1
+              },
+              "candidateId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "sourceArtifact": {
+                "type": "string",
+                "minLength": 1
+              },
+              "sourceUrl": {
+                "type": "string",
+                "minLength": 1
+              },
+              "localPath": {
+                "type": "string",
+                "minLength": 1
+              },
+              "fileExists": {
+                "type": "boolean"
+              },
+              "bytes": {
+                "type": "number",
+                "minimum": 0
+              },
+              "sha256": {
+                "type": "string",
+                "minLength": 64
+              },
+              "detectedMimeType": {
+                "type": "string",
+                "minLength": 1
+              },
+              "width": {
+                "type": "number",
+                "minimum": 0
+              },
+              "height": {
+                "type": "number",
+                "minimum": 0
+              },
+              "duplicateHashGroupId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "findingCodes": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "findings": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "code",
+                    "evidence"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "evidence": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/media-manifest.schema.json ADDED Viewed

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/media-manifest.schema.json",
+  "title": "Storewright Media Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "authoring", "media"],
+  "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 }
+        }
+      }
+    },
+    "media": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["assets"],
+      "properties": {
+        "assets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "anyOf": [
+              {
+                "type": "object",
+                "required": ["status"],
+                "properties": {
+                  "status": {
+                    "enum": ["source-downloaded", "generation-required", "upload-blocked", "uploaded"]
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "required": ["status", "seoFilename"],
+                "properties": {
+                  "status": { "const": "ready-for-upload" }
+                }
+              }
+            ],
+            "required": ["assetId", "origin", "localPath", "mimeType", "status", "altText", "sourceArtifact"],
+            "properties": {
+              "assetId": { "type": "string", "minLength": 1 },
+              "slotId": { "type": "string", "minLength": 1 },
+              "candidateId": { "type": "string", "minLength": 1 },
+              "origin": {
+                "type": "string",
+                "enum": ["supplier", "product-derived", "generated", "supplied", "shopify-existing"]
+              },
+              "localPath": { "type": "string", "minLength": 1 },
+              "mimeType": { "type": "string", "minLength": 1 },
+              "status": {
+                "type": "string",
+                "enum": ["source-downloaded", "generation-required", "ready-for-upload", "upload-blocked", "uploaded"]
+              },
+              "seoFilename": {
+                "type": "string",
+                "minLength": 5,
+                "maxLength": 180,
+                "pattern": "^(?!image-[0-9]+\\.)[a-z0-9]+(?:-[a-z0-9]+)*\\.[a-z0-9]+$"
+              },
+              "altText": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "sourceArtifact": { "type": "string", "minLength": 1 },
+              "provenance": { "type": "object" },
+              "warnings": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/merchandising-brief.schema.json ADDED Viewed

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/merchandising-brief.schema.json",
+  "title": "Merchandising Brief",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "merchandisingBrief"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "merchandisingBrief": {
+      "type": "object",
+      "required": ["primaryCollections", "navItems", "heroFocus"],
+      "properties": {
+        "targetAudience": {},
+        "categoryStrategy": {},
+        "primaryCollections": { "type": "array" },
+        "secondaryCollections": { "type": "array" },
+        "heroFocus": {},
+        "navItems": { "type": "array" },
+        "featuredCollectionIdeas": { "type": "array" },
+        "productCountRange": {},
+        "pricePositioning": {},
+        "contentAngles": { "type": "array" }
+      }
+    }
+  }
+}

package/schemas/normalized-product-catalog.schema.json ADDED Viewed

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/normalized-product-catalog.schema.json",
+  "title": "Normalized Product Catalog",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "authoring", "normalizedProductCatalog"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "authoring": {
+      "type": "object",
+      "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 }
+        }
+      }
+    },
+    "normalizedProductCatalog": {
+      "type": "object",
+      "required": ["products"],
+      "properties": {
+        "products": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["title", "fieldStatus", "writeEligibility"],
+            "properties": {
+              "title": { "type": "string" },
+              "fieldStatus": { "type": "object" },
+              "writeEligibility": { "type": "object" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/product-content-generation-input.schema.json ADDED Viewed

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/product-content-generation-input.schema.json",
+  "title": "Product Content Generation Input",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "productContentGeneration"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "productContentGeneration": {
+      "type": "object",
+      "required": ["status", "items"],
+      "properties": {
+        "status": { "type": "string" },
+        "instructions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["candidateId", "brandName", "category", "raw", "requiredOutput"],
+            "properties": {
+              "candidateId": { "type": "string" },
+              "source": { "type": "string" },
+              "brandName": { "type": "string" },
+              "category": { "type": "string" },
+              "market": { "type": "string" },
+              "currency": { "type": "string" },
+              "collectionHint": { "type": "string" },
+              "raw": { "type": "object" },
+              "requiredOutput": { "type": "object" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/product-content-generation-output.schema.json ADDED Viewed

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/product-content-generation-output.schema.json",
+  "title": "Product Content Generation Output",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "productContentGeneration"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "productContentGeneration": {
+      "type": "object",
+      "required": ["status", "items"],
+      "properties": {
+        "status": { "type": "string" },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["candidateId", "title", "description"],
+            "properties": {
+              "candidateId": { "type": "string" },
+              "title": { "type": "string" },
+              "description": { "type": "string" },
+              "productType": { "type": "string" },
+              "collectionHint": { "type": "string" },
+              "tags": {
+                "type": "array",
+                "items": { "type": "string" }
+              },
+              "seo": {
+                "type": "object",
+                "properties": {
+                  "title": { "type": "string" },
+                  "description": { "type": "string" }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/raw-product-candidates.schema.json ADDED Viewed

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/storewright/raw-product-candidates.schema.json",
+  "title": "Raw Product Candidates",
+  "type": "object",
+  "required": ["schemaVersion", "runId", "rawProductCandidates"],
+  "properties": {
+    "schemaVersion": { "type": "string" },
+    "runId": { "type": "string" },
+    "rawProductCandidates": {
+      "type": "object",
+      "required": ["status", "items"],
+      "properties": {
+        "status": { "type": "string" },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["type"],
+            "properties": {
+              "type": { "enum": ["supplier-url", "local-product", "manual-brief"] },
+              "supplierUrl": { "type": "string" },
+              "title": { "type": "string" },
+              "collectionHint": { "type": "string" },
+              "localImages": { "type": "array" }
+            }
+          }
+        }
+      }
+    }
+  }
+}