@storewright/cli 0.14.0

package/README.md

@@ -0,0 +1,19 @@
+# Storewright CLI
+
+Public CLI bootstrap and deterministic helper commands for Storewright.
+
+Install:
+
+```bash
+npm install -g @storewright/cli
+```
+
+Install or refresh the private Codex Storewright plugin:
+
+```bash
+storewright codex install
+```
+
+This command registers the private Storewright marketplace, installs the Codex plugin, copies Storewright agent profiles from the installed plugin into `~/.codex/agents`, and writes `~/.codex/storewright/codex-install-report.json`.
+
+After installation, start a new Codex session so the runtime discovers the agent profiles.

package/VERSION

@@ -0,0 +1 @@
+0.14.0

package/bin/storewright.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+
+import {
+  installCodexStorewright,
+  parseCodexInstallArgs,
+  resolveScriptForCommand,
+  scriptPathForCommand
+} from "../lib/cli/storewright-cli.mjs";
+
+function usage() {
+  return [
+    "Usage:",
+    "  storewright codex install [--source git|local|marketplace] [--marketplace-root <path>] [--marketplace <name>] [--codex-home <path>]",
+    "  storewright run init [init-run-state args]",
+    "  storewright run audit [audit-run-state args]",
+    "  storewright artifact validate [validate-artifact args]",
+    "  storewright launch-envelope prepare|validate [args]",
+    "  storewright agent-report validate [args]",
+    "  storewright registries validate [--package-root <plugin-skill-root>]",
+    "  storewright workflow-manifest validate [--package-root <plugin-skill-root>]",
+    "  storewright shopify access-preflight [args]",
+    "  storewright shopify operation execute [args]",
+    "  storewright media inspect|generate|generate-openai|upload [args]",
+    "  storewright version [version args]"
+  ].join("\n");
+}
+
+async function main(argv = process.argv.slice(2)) {
+  if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+    console.log(usage());
+    return;
+  }
+
+  if (argv[0] === "codex" && argv[1] === "install") {
+    const report = await installCodexStorewright(parseCodexInstallArgs(argv.slice(2)));
+    console.log(JSON.stringify(report, null, 2));
+    console.error("Start a new Codex session so Storewright agent profiles are loaded into the runtime.");
+    return;
+  }
+
+  const resolved = resolveScriptForCommand(argv);
+  if (!resolved) {
+    throw new Error(`Unknown Storewright command: ${argv.join(" ")}\n\n${usage()}`);
+  }
+
+  const result = spawnSync(process.execPath, [scriptPathForCommand(resolved.script), ...resolved.passthrough], {
+    stdio: "inherit",
+    env: process.env
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  process.exitCode = result.status ?? 1;
+}
+
+try {
+  await main();
+} catch (error) {
+  console.error(error.message);
+  process.exitCode = 1;
+}

package/contracts/action-registry.json

@@ -0,0 +1,175 @@
+{
+  "schemaVersion": "1.0.0",
+  "actions": {
+    "storewright.artifacts.write": {
+      "executor": {
+        "server": "workspace",
+        "tool": "artifact_write"
+      },
+      "requiredScopes": [],
+      "requiredPreconditions": [],
+      "impactClass": "local-only",
+      "approvalRequirement": "none"
+    },
+    "storewright.browser.captureEvidence": {
+      "executor": {
+        "server": "browser-evidence",
+        "tool": "capture_page"
+      },
+      "requiredScopes": [],
+      "requiredPreconditions": [],
+      "impactClass": "local-only",
+      "approvalRequirement": "workflow-gate"
+    },
+    "storewright.media.generate": {
+      "executor": {
+        "server": "media-generation",
+        "tool": "generate_media"
+      },
+      "requiredScopes": [],
+      "requiredPreconditions": [],
+      "impactClass": "local-only",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.auth.preflight": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "shopify_preflight"
+      },
+      "requiredScopes": [],
+      "requiredPreconditions": [],
+      "impactClass": "remote-read",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.media.upload": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "media_upload"
+      },
+      "requiredScopes": [
+        "write_files"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.products.upsert": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "catalog_upsert"
+      },
+      "requiredScopes": [
+        "write_products"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.products.publishToOnlineStore": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "publishable_publish"
+      },
+      "requiredScopes": [
+        "write_products",
+        "write_publications"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed",
+        "online-store-publication-resolved"
+      ],
+      "impactClass": "remote-public",
+      "approvalRequirement": "explicit-user"
+    },
+    "shopify.collections.upsert": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "collection_upsert"
+      },
+      "requiredScopes": [
+        "write_products"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.collections.attachProducts": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "collection_attach_products"
+      },
+      "requiredScopes": [
+        "write_products"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.collections.publishToOnlineStore": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "publishable_publish"
+      },
+      "requiredScopes": [
+        "write_products",
+        "write_publications"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed",
+        "online-store-publication-resolved"
+      ],
+      "impactClass": "remote-public",
+      "approvalRequirement": "explicit-user"
+    },
+    "shopify.content.upsertPages": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "content_upsert_pages"
+      },
+      "requiredScopes": [
+        "write_content"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.navigation.upsertPreviewMenu": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "navigation_upsert_preview_menu"
+      },
+      "requiredScopes": [
+        "write_online_store_navigation"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    },
+    "shopify.theme.pushUnpublished": {
+      "executor": {
+        "server": "storewright-operations",
+        "tool": "theme_push_unpublished"
+      },
+      "requiredScopes": [
+        "write_themes"
+      ],
+      "requiredPreconditions": [
+        "shopify-preflight-passed"
+      ],
+      "impactClass": "remote-draft",
+      "approvalRequirement": "workflow-gate"
+    }
+  }
+}

package/contracts/capability-registry.json

@@ -0,0 +1,63 @@
+{
+  "schemaVersion": "1.0.0",
+  "profiles": {
+    "storewright-stage-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write"
+      ]
+    },
+    "storewright-browser-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write",
+        "storewright.browser.captureEvidence"
+      ]
+    },
+    "storewright-media-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write",
+        "storewright.media.generate"
+      ]
+    },
+    "storewright-theme-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write"
+      ]
+    },
+    "storewright-shopify-read-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write",
+        "shopify.auth.preflight"
+      ]
+    },
+    "storewright-shopify-catalog-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write",
+        "shopify.media.upload",
+        "shopify.products.upsert",
+        "shopify.products.publishToOnlineStore",
+        "shopify.collections.upsert",
+        "shopify.collections.attachProducts",
+        "shopify.collections.publishToOnlineStore"
+      ]
+    },
+    "storewright-shopify-content-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write",
+        "shopify.content.upsertPages",
+        "shopify.navigation.upsertPreviewMenu"
+      ]
+    },
+    "storewright-shopify-theme-deploy-worker": {
+      "allowedActions": [
+        "storewright.artifacts.write",
+        "shopify.theme.pushUnpublished"
+      ]
+    },
+    "storewright-reviewer": {
+      "allowedActions": []
+    },
+    "storewright-verifier": {
+      "allowedActions": []
+    }
+  }
+}

package/contracts/workflow-manifest.json

@@ -0,0 +1,207 @@
+{
+  "schemaVersion": "1.0.0",
+  "workflowId": "storewright-official-build",
+  "workflowVersion": "1.0.0",
+  "stages": [
+    {
+      "id": "01",
+      "name": "Intake",
+      "ownerProfile": "intake-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/01-intake.md",
+      "spec": "workflows/stage-specs/01-intake.json",
+      "gateSpec": "workflows/gate-specs/01-intake.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "01A",
+      "name": "Shopify Access Preflight",
+      "ownerProfile": "shopify-access-preflight-worker",
+      "runtimeAgentType": "storewright-shopify-read-worker",
+      "packet": "workflows/stages/01A-shopify-access-preflight.md",
+      "spec": "workflows/stage-specs/01A-shopify-access-preflight.json",
+      "gateSpec": "workflows/gate-specs/01A-shopify-access-preflight.json",
+      "actionPolicyRef": "storewright.shopify-preflight"
+    },
+    {
+      "id": "02",
+      "name": "Product Source Normalize",
+      "ownerProfile": "product-source-normalize-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/02-product-source-normalize.md",
+      "spec": "workflows/stage-specs/02-product-source-normalize.json",
+      "gateSpec": "workflows/gate-specs/02-product-source-normalize.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "03",
+      "name": "Supplier Extraction",
+      "ownerProfile": "supplier-extraction-worker",
+      "runtimeAgentType": "storewright-browser-worker",
+      "packet": "workflows/stages/03-supplier-extraction.md",
+      "spec": "workflows/stage-specs/03-supplier-extraction.json",
+      "gateSpec": "workflows/gate-specs/03-supplier-extraction.json",
+      "actionPolicyRef": "storewright.supplier-extraction.browser-evidence"
+    },
+    {
+      "id": "04",
+      "name": "Product Content",
+      "ownerProfile": "product-content-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/04-product-content.md",
+      "spec": "workflows/stage-specs/04-product-content.json",
+      "gateSpec": "workflows/gate-specs/04-product-content.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "05",
+      "name": "Merchandising Strategy",
+      "ownerProfile": "merchandising-strategy-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/05-merchandising-strategy.md",
+      "spec": "workflows/stage-specs/05-merchandising-strategy.json",
+      "gateSpec": "workflows/gate-specs/05-merchandising-strategy.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "06",
+      "name": "Brand Identity",
+      "ownerProfile": "brand-identity-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/06-brand-identity.md",
+      "spec": "workflows/stage-specs/06-brand-identity.json",
+      "gateSpec": "workflows/gate-specs/06-brand-identity.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "07",
+      "name": "Store Content",
+      "ownerProfile": "store-content-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/07-store-content.md",
+      "spec": "workflows/stage-specs/07-store-content.json",
+      "gateSpec": "workflows/gate-specs/07-store-content.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "08",
+      "name": "Design Direction",
+      "ownerProfile": "design-direction-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/08-design-direction.md",
+      "spec": "workflows/stage-specs/08-design-direction.json",
+      "gateSpec": "workflows/gate-specs/08-design-direction.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "09",
+      "name": "Store Blueprint",
+      "ownerProfile": "store-blueprint-worker",
+      "runtimeAgentType": "storewright-stage-worker",
+      "packet": "workflows/stages/09-store-blueprint.md",
+      "spec": "workflows/stage-specs/09-store-blueprint.json",
+      "gateSpec": "workflows/gate-specs/09-store-blueprint.json",
+      "actionPolicyRef": "storewright.local-authoring"
+    },
+    {
+      "id": "09A",
+      "name": "Media Production",
+      "ownerProfile": "media-production-worker",
+      "runtimeAgentType": "storewright-media-worker",
+      "packet": "workflows/stages/09A-media-production.md",
+      "spec": "workflows/stage-specs/09A-media-production.json",
+      "gateSpec": "workflows/gate-specs/09A-media-production.json",
+      "actionPolicyRef": "storewright.media-production"
+    },
+    {
+      "id": "09B",
+      "name": "Shopify Media Upload",
+      "ownerProfile": "shopify-media-upload-worker",
+      "runtimeAgentType": "storewright-shopify-catalog-worker",
+      "packet": "workflows/stages/09B-shopify-media-upload.md",
+      "spec": "workflows/stage-specs/09B-shopify-media-upload.json",
+      "gateSpec": "workflows/gate-specs/09B-shopify-media-upload.json",
+      "actionPolicyRef": "storewright.shopify-media-upload"
+    },
+    {
+      "id": "10",
+      "name": "Theme Build And Apply",
+      "ownerProfile": "theme-build-worker",
+      "runtimeAgentType": "storewright-theme-worker",
+      "packet": "workflows/stages/10-theme-build-and-apply.md",
+      "spec": "workflows/stage-specs/10-theme-build-and-apply.json",
+      "gateSpec": "workflows/gate-specs/10-theme-build-and-apply.json",
+      "actionPolicyRef": "storewright.theme-local"
+    },
+    {
+      "id": "11A",
+      "name": "Shopify Preflight Auth Scope",
+      "ownerProfile": "store-ops-preflight-worker",
+      "runtimeAgentType": "storewright-shopify-read-worker",
+      "packet": "workflows/stages/11A-shopify-preflight-auth-scope.md",
+      "spec": "workflows/stage-specs/11A-shopify-preflight-auth-scope.json",
+      "gateSpec": "workflows/gate-specs/11A-shopify-preflight-auth-scope.json",
+      "actionPolicyRef": "storewright.shopify-preflight"
+    },
+    {
+      "id": "11B",
+      "name": "Shopify Products Collections",
+      "ownerProfile": "store-ops-products-worker",
+      "runtimeAgentType": "storewright-shopify-catalog-worker",
+      "packet": "workflows/stages/11B-shopify-products-collections.md",
+      "spec": "workflows/stage-specs/11B-shopify-products-collections.json",
+      "gateSpec": "workflows/gate-specs/11B-shopify-products-collections.json",
+      "actionPolicyRef": "storewright.shopify-catalog"
+    },
+    {
+      "id": "11C",
+      "name": "Shopify Content Navigation",
+      "ownerProfile": "store-ops-content-worker",
+      "runtimeAgentType": "storewright-shopify-content-worker",
+      "packet": "workflows/stages/11C-shopify-content-navigation.md",
+      "spec": "workflows/stage-specs/11C-shopify-content-navigation.json",
+      "gateSpec": "workflows/gate-specs/11C-shopify-content-navigation.json",
+      "actionPolicyRef": "storewright.shopify-content"
+    },
+    {
+      "id": "11D",
+      "name": "Shopify Theme Push",
+      "ownerProfile": "store-ops-theme-worker",
+      "runtimeAgentType": "storewright-shopify-theme-deploy-worker",
+      "packet": "workflows/stages/11D-shopify-theme-push.md",
+      "spec": "workflows/stage-specs/11D-shopify-theme-push.json",
+      "gateSpec": "workflows/gate-specs/11D-shopify-theme-push.json",
+      "actionPolicyRef": "storewright.shopify-theme-deploy"
+    },
+    {
+      "id": "11E",
+      "name": "Shopify Store Ops Consolidation",
+      "ownerProfile": "store-ops-consolidation-worker",
+      "runtimeAgentType": "storewright-shopify-read-worker",
+      "packet": "workflows/stages/11E-shopify-store-ops-consolidation.md",
+      "spec": "workflows/stage-specs/11E-shopify-store-ops-consolidation.json",
+      "gateSpec": "workflows/gate-specs/11E-shopify-store-ops-consolidation.json",
+      "actionPolicyRef": "storewright.shopify-consolidation"
+    },
+    {
+      "id": "11F",
+      "name": "Storefront Preview Acceptance Review",
+      "ownerProfile": "storefront-preview-review-worker",
+      "runtimeAgentType": "storewright-browser-worker",
+      "packet": "workflows/stages/11F-storefront-preview-acceptance-review.md",
+      "spec": "workflows/stage-specs/11F-storefront-preview-acceptance-review.json",
+      "gateSpec": "workflows/gate-specs/11F-storefront-preview-acceptance-review.json",
+      "actionPolicyRef": "storewright.storefront-preview-review"
+    },
+    {
+      "id": "12",
+      "name": "Launch Readiness",
+      "ownerProfile": "launch-readiness-worker",
+      "runtimeAgentType": "storewright-verifier",
+      "packet": "workflows/stages/12-launch-readiness.md",
+      "spec": "workflows/stage-specs/12-launch-readiness.json",
+      "gateSpec": "workflows/gate-specs/12-launch-readiness.json",
+      "actionPolicyRef": "storewright.launch-readiness"
+    }
+  ]
+}