{
  "package": "@ultracart/storefront-cli",
  "cliVersion": "0.2.0-beta.9",
  "generatedFrom": "uc-storefront --help",
  "reference": "/developer/storefront/agent-toolchain/command-reference",
  "globalOptions": [
    {
      "flags": "-V, --version",
      "description": "output the version number"
    },
    {
      "flags": "--workspace <directory>",
      "description": "exact workspace manifest root (file arguments stay relative to cwd)"
    },
    {
      "flags": "--timings",
      "description": "emit credential-free phase timings as a JSON line on stderr"
    },
    {
      "flags": "--catalog-dir <directory>",
      "description": "normalized catalog directory (or ULTRACART_STOREFRONT_CATALOG_DIR)"
    },
    {
      "flags": "--profile <name-or-uuid>",
      "description": "merchant profile (or ULTRACART_PROFILE, workspace binding, or current profile)"
    },
    {
      "flags": "--format <format>",
      "description": "output human-readable text or stable JSON (choices: \"text\", \"json\", default: \"text\")"
    },
    {
      "flags": "--json",
      "description": "alias for --format json"
    }
  ],
  "commands": [
    {
      "path": "profile",
      "usage": "profile",
      "description": "Manage local merchant profile metadata and workspace selection",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile list",
      "usage": "profile list",
      "description": "List configured profiles without reading credentials",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile create",
      "usage": "profile create <name>",
      "description": "Create nonsecret metadata for a merchant profile",
      "options": [
        {
          "flags": "--registration <id>",
          "description": "trusted OAuth registration manifest ID"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile show",
      "usage": "profile show [name-or-uuid]",
      "description": "Show a profile selected by name, UUID, environment, workspace, or default",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile use",
      "usage": "profile use <name-or-uuid>",
      "description": "Set the global current profile",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile rename",
      "usage": "profile rename <name-or-uuid> <new-name>",
      "description": "Rename a profile without changing its UUID or credential key",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile remove",
      "usage": "profile remove <name-or-uuid>",
      "description": "Remove profile metadata and associated credentials",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile bind",
      "usage": "profile bind <name-or-uuid>",
      "description": "Bind a workspace to one profile and optional expected merchant",
      "options": [
        {
          "flags": "--directory <directory>",
          "description": "workspace directory; defaults to the selected workspace"
        },
        {
          "flags": "--merchant-id <merchant-id>",
          "description": "expected authenticated merchant ID"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "profile unbind",
      "usage": "profile unbind",
      "description": "Remove the nearest workspace binding",
      "options": [
        {
          "flags": "--directory <directory>",
          "description": "exact workspace directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "auth",
      "usage": "auth",
      "description": "Manage authentication and inspect credential state",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "auth login",
      "usage": "auth login",
      "description": "Authenticate a merchant profile using interactive OAuth device flow",
      "options": [
        {
          "flags": "--profile <name-or-uuid>",
          "description": "profile name or UUID to authenticate"
        },
        {
          "flags": "--registration <id>",
          "description": "trusted OAuth registration manifest ID"
        },
        {
          "flags": "--no-wait",
          "description": "start the sign-in, print the URL and code, and exit at once; finish it with --continue"
        },
        {
          "flags": "--continue",
          "description": "finish a sign-in started with --no-wait: exit 0 when signed in, 3 while still waiting"
        },
        {
          "flags": "--wait [seconds]",
          "description": "with --continue, keep polling up to this long (default 45 s, capped at the code's expiry)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "auth approve-location",
      "usage": "auth approve-location",
      "description": "Ask the person who signed in to approve this sign-in's use from the current IP address",
      "options": [
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish a request already made (after 'sf approvals wait <id>')"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "auth status",
      "usage": "auth status",
      "description": "Report redacted local credential and profile readiness, including when the sign-in expires",
      "options": [
        {
          "flags": "--remote",
          "description": "also check current beta access with whoami; may refresh credentials"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "auth logout",
      "usage": "auth logout",
      "description": "Revoke OAuth refresh token and remove credentials for a merchant profile",
      "options": [
        {
          "flags": "--profile <name-or-uuid>",
          "description": "profile name or UUID to log out"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "auth keygen",
      "usage": "auth keygen",
      "description": "For a person at a terminal: print a new key for the encrypted-file sign-in (never run it where an agent can see the output)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "sf",
      "usage": "sf",
      "description": "Read, render, and upload UltraCart StoreFront resources",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf sizes",
      "usage": "sf sizes",
      "description": "Measure and manage local responsive-image widths",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf sizes measure",
      "usage": "sf sizes measure <file>",
      "description": "Measure one local container in a temporary preview and write a new sizes plan",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme to render"
        },
        {
          "flags": "--path <path>",
          "description": "representative storefront page"
        },
        {
          "flags": "--out <file>",
          "description": "new local measurement plan; never overwritten"
        },
        {
          "flags": "--to <path>",
          "description": "destination represented by the source; defaults to its pull baseline"
        },
        {
          "flags": "--file <local=remote>",
          "description": "additional layout container to stage; repeat for each (default: [])"
        },
        {
          "flags": "--chrome <path>",
          "description": "Chrome executable; defaults to installed Chrome"
        },
        {
          "flags": "--settle-ms <ms>",
          "description": "bounded settling budget per viewport, 100–10000 ms"
        },
        {
          "flags": "--resize-quiet-ms <ms>",
          "description": "wait after each viewport change for theme resize handlers, 0–5000 ms (default 300)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf sizes apply",
      "usage": "sf sizes apply <file>",
      "description": "Apply a source-bound sizes plan to one local file; never push",
      "options": [
        {
          "flags": "--plan <file>",
          "description": "measurement plan produced by sf sizes measure"
        },
        {
          "flags": "--dry-run",
          "description": "report changes without writing"
        },
        {
          "flags": "--allow-partial",
          "description": "apply measured and not-displayed entries, preserving unresolved ones"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf sizes clear",
      "usage": "sf sizes clear <file> <selector>",
      "description": "Clear only the selected widget's measured sizes in a local file; never descendants",
      "options": [
        {
          "flags": "--dry-run",
          "description": "report previous measurements without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf surveys",
      "usage": "sf surveys",
      "description": "Check SurveyJS survey definition files offline",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/surveys"
    },
    {
      "path": "sf surveys validate",
      "usage": "sf surveys validate <file>",
      "description": "Validate a SurveyJS survey JSON file against the SurveyJS version the storefront loads, as the catalog declares it. Offline and needs no login. A broken survey otherwise fails silently: the visitor sees an empty space and nothing reports why",
      "options": [
        {
          "flags": "--disqualified",
          "description": "the widget sets surveyDisqualifiedUrl; require a 'disqualified' value in the survey"
        },
        {
          "flags": "--limit <count>",
          "description": "maximum diagnostics to print (default: 100)"
        },
        {
          "flags": "--all",
          "description": "print every diagnostic"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/surveys"
    },
    {
      "path": "sf ids",
      "usage": "sf ids",
      "description": "Reserve server widget IDs (requests above 100 are chunked)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--count <number>",
          "description": "IDs to reserve, from 1 through 10000 (default: 1)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf storefronts",
      "usage": "sf storefronts",
      "description": "List storefronts available to the authenticated profile",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf themes",
      "usage": "sf themes",
      "description": "List a storefront's themes, check an upgrade, or duplicate a theme (optionally upgrading the copy)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid (required)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf themes upgrade-check",
      "usage": "sf themes upgrade-check",
      "description": "Show what upgrading a theme would do, without changing anything",
      "options": [
        {
          "flags": "--theme <oid>",
          "description": "theme oid, from 'sf themes'"
        },
        {
          "flags": "--upgrade-to <version>",
          "description": "the version to check (default: the newest available)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf themes duplicate",
      "usage": "sf themes duplicate",
      "description": "Copy a theme into a new, inactive theme, and optionally upgrade only the copy",
      "options": [
        {
          "flags": "--theme <oid>",
          "description": "theme to copy, from 'sf themes'"
        },
        {
          "flags": "--folder <name>",
          "description": "folder for the copy, under /themes/"
        },
        {
          "flags": "--target-storefront <oid>",
          "description": "storefront to copy into (default: --storefront)"
        },
        {
          "flags": "--upgrade-to <version>",
          "description": "upgrade the copy to this version"
        },
        {
          "flags": "--wait [seconds]",
          "description": "poll until the copy is made (default 600 s)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf themes job",
      "usage": "sf themes job <job-id>",
      "description": "Check a theme duplicate job once",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf elements",
      "usage": "sf elements",
      "description": "Read the server's element vocabulary, config schemas and Markdown field cards",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "sf elements list",
      "usage": "sf elements list",
      "description": "List server element types and schema/doc availability flags",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "sf elements get",
      "usage": "sf elements get <type>",
      "description": "Read a server config schema (JSON string) and Markdown doc; report unpublished fields explicitly",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "sf pages",
      "usage": "sf pages",
      "description": "Read and update catalog page attributes and images used by pageattribute/pageimage",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages get",
      "usage": "sf pages get",
      "description": "Read page attributes, image slots and template declaration metadata",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "catalog group path"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages attributes",
      "usage": "sf pages attributes <file>",
      "description": "Apply a partial attribute update from JSON; empty string clears a value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "catalog group path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing page data shared by every theme"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages refresh",
      "usage": "sf pages refresh <url>",
      "description": "Drop one page's cached copy so the next request renders it fresh",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages images",
      "usage": "sf pages images",
      "description": "Attach or detach the page's default or coded image",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages images attach",
      "usage": "sf pages images attach <filename>",
      "description": "Attach a raster image already uploaded into the page folder",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "catalog group path"
        },
        {
          "flags": "--code <code>",
          "description": "named image slot (exclusive with --default)"
        },
        {
          "flags": "--default",
          "description": "default image shown by subgroup tiles"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing page data shared by every theme"
        },
        {
          "flags": "--description <text>",
          "description": "image description/alt text"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages images detach",
      "usage": "sf pages images detach",
      "description": "Detach a page image; keep the uploaded source file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "catalog group path"
        },
        {
          "flags": "--code <code>",
          "description": "named image slot (exclusive with --default)"
        },
        {
          "flags": "--default",
          "description": "default image shown by subgroup tiles"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing page data shared by every theme"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages list",
      "usage": "sf pages list",
      "description": "List every page with its settings, or the pages under one path",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--under <path>",
          "description": "only this page and the pages below it"
        },
        {
          "flags": "--template <vm>",
          "description": "only pages whose group_template or item_template is this file name, such as template_catalog.vm; a path is refused"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages templates",
      "usage": "sf pages templates",
      "description": "List the active theme's templates and what each can render",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--type <page type>",
          "description": "only templates declaring this page type: group for a page's --template, item for its --item-template"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages create",
      "usage": "sf pages create <path>",
      "description": "Create a page under an existing parent page",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--template <vm>",
          "description": "template that renders the page"
        },
        {
          "flags": "--item-template <vm>",
          "description": "template that renders item pages under it"
        },
        {
          "flags": "--title <title>",
          "description": "page title"
        },
        {
          "flags": "--description <text>",
          "description": "page description"
        },
        {
          "flags": "--page-type <type>",
          "description": "S for static, D for dynamic (default D)"
        },
        {
          "flags": "--no-sitemap",
          "description": "leave the page out of the sitemap and serve it with X-Robots-Tag: noindex; this page only, not pages under it"
        },
        {
          "flags": "--noindex",
          "description": "same as --no-sitemap: hide the page from search engines"
        },
        {
          "flags": "--hidden",
          "description": "create it hidden, so it answers 404 until shown"
        },
        {
          "flags": "--visible-at <iso>",
          "description": "keep it hidden until this time"
        },
        {
          "flags": "--live",
          "description": "acknowledge creating a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages settings",
      "usage": "sf pages settings <file>",
      "description": "Change page settings from a JSON object; only the fields sent change",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live page"
        },
        {
          "flags": "--redirect-old-url <301>",
          "description": "with \"visible\": false: also add a 301 from the page's address to --redirect-target"
        },
        {
          "flags": "--redirect-target <path>",
          "description": "where the hidden page's address sends visitors"
        },
        {
          "flags": "--redirect-note <text>",
          "description": "note stored on the redirect rule"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages move",
      "usage": "sf pages move <path> <new_path>",
      "description": "Move or rename a page, with its sub-pages, items and folder, once the signed-in person approves; optionally redirect the old addresses",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--redirect-old-url <301>",
          "description": "also add a 301 from the old addresses to the new ones"
        },
        {
          "flags": "--note <text>",
          "description": "note stored on the redirect rule (with --redirect-old-url)"
        },
        {
          "flags": "--dry-run",
          "description": "check the move and report what would move; no approval, nothing changes"
        },
        {
          "flags": "--live",
          "description": "required for the real move: acknowledge changing live addresses"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why this page should move (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages duplicate",
      "usage": "sf pages duplicate <source> <target>",
      "description": "Copy a page, with its body, attributes, images and assignments, to a new path",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--title <title>",
          "description": "title of the copy (default: the source's)"
        },
        {
          "flags": "--live",
          "description": "acknowledge creating a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages items",
      "usage": "sf pages items",
      "description": "Read, add or remove the items assigned to a page",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages items get",
      "usage": "sf pages items get",
      "description": "Read the page's items with their sort order and url part",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages items add",
      "usage": "sf pages items add <file>",
      "description": "Assign items from {\"items\":[{\"item_id\":\"SKU-1\",\"url_part\":\"sku-1\"}]}; use sort_order only when the page has custom item sorting (C)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages items remove",
      "usage": "sf pages items remove <itemIds...>",
      "description": "Take items off the page; the items themselves are not touched",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages blog-posts",
      "usage": "sf pages blog-posts",
      "description": "Read, add or remove the blog posts assigned to a page",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages blog-posts get",
      "usage": "sf pages blog-posts get",
      "description": "Read the blog posts the page shows",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages blog-posts add",
      "usage": "sf pages blog-posts add <oids...>",
      "description": "Assign blog posts by oid",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages blog-posts remove",
      "usage": "sf pages blog-posts remove <oids...>",
      "description": "Take blog posts off the page",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages selectors",
      "usage": "sf pages selectors",
      "description": "Read or replace the selectors that choose a page's items and blog posts",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages selectors get",
      "usage": "sf pages selectors get",
      "description": "Read the item and blog post selectors",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf pages selectors set",
      "usage": "sf pages selectors set <file>",
      "description": "Replace selector sets from JSON; each list sent replaces that set, an empty list clears it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page path"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf site",
      "usage": "sf site",
      "description": "Read and update the storefront's site attributes used by siteattribute and $site.attr, its search engine settings, and read its sitemaps",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf site get",
      "usage": "sf site get",
      "description": "Read every site attribute with its type, writability and theme usage",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf site attributes",
      "usage": "sf site attributes <file>",
      "description": "Apply a partial site attribute update from JSON; empty string clears a value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing attributes every theme reads"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf site seo",
      "usage": "sf site seo",
      "description": "Read the search engine settings: Canonical Links, Schema.org and Prevent Indexing, the default meta description and keywords, and the hash for seo-set",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf site seo-set",
      "usage": "sf site seo-set",
      "description": "Turn Canonical Links, Schema.org or Prevent Indexing on or off; some changes need the signed-in person's approval",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--canonical <on|off>",
          "description": "Canonical Links: on needs no approval, off needs approval"
        },
        {
          "flags": "--schema-org <on|off>",
          "description": "Schema.org structured data: on needs no approval, off needs approval"
        },
        {
          "flags": "--prevent-indexing <on|off>",
          "description": "tell search engines not to index any page: approval both ways, and on asks for a fresh authenticator code"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 from 'sf site seo', instead of reading it now"
        },
        {
          "flags": "--dry-run",
          "description": "show each change, whether it needs approval and a fresh code, and write nothing; needs no --live"
        },
        {
          "flags": "--live",
          "description": "required to write: acknowledge a change every page shows at once"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why this change (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf site sitemaps",
      "usage": "sf site sitemaps",
      "description": "Read the storefront's sitemap URLs, their child files and build times, and robots.txt's Sitemap lines",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf theme-attributes",
      "usage": "sf theme-attributes",
      "description": "Read and change a theme's applied colours, fonts and settings",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf theme-attributes get",
      "usage": "sf theme-attributes get",
      "description": "List a theme's colour and font slots with value, default and description (--all for every slot)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid from 'sf themes'"
        },
        {
          "flags": "--all",
          "description": "include every slot type, not only color, rgba and font"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf theme-attributes set",
      "usage": "sf theme-attributes set",
      "description": "Change one or more slots in a single partial update",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid from 'sf themes'"
        },
        {
          "flags": "--set <name=value>",
          "description": "slot to change; repeatable; a font takes a JSON font object (default: [])"
        },
        {
          "flags": "--file <patch.json>",
          "description": "{\"attributes\":[{\"name\":\"...\",\"value\":\"...\"} or {\"name\":\"...\",\"font\":{...}}]}"
        },
        {
          "flags": "--live",
          "description": "acknowledge repainting the active theme"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf search",
      "usage": "sf search",
      "description": "Read and change the storefront's catalog search settings",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf search facets",
      "usage": "sf search facets",
      "description": "Read and change faceted search: which facets the facet sidebar offers, their headings and the Cost price points",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf search facets get",
      "usage": "sf search facets get",
      "description": "List each facet with its heading and whether it's on, the Cost price points, and the hash for 'set --if-match'",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf search facets set",
      "usage": "sf search facets set",
      "description": "Turn facets on or off, rename their headings or set the Cost price points, in one partial update",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--enable <name>",
          "description": "turn a facet on; repeatable (facet_cost, or just cost) (default: [])"
        },
        {
          "flags": "--disable <name>",
          "description": "turn a facet off; repeatable (default: [])"
        },
        {
          "flags": "--display-name <name=text>",
          "description": "the heading shoppers see, 1-100 characters of plain text; repeatable (default: [])"
        },
        {
          "flags": "--csv <name=on|off>",
          "description": "the facet's CSV setting, as on the admin screen; repeatable (default: [])"
        },
        {
          "flags": "--price-points <list>",
          "description": "the Cost facet's price points: 1-20 increasing whole amounts in the base currency, such as 25,50,100,200; replaces the list"
        },
        {
          "flags": "--file <patch.json>",
          "description": "{\"facets\":[{\"name\":\"facet_cost\",\"enabled\":true,\"display_name\":\"Price\"}],\"cost_price_points\":[25,50,100,200]}"
        },
        {
          "flags": "--restore <get.json>",
          "description": "put back a saved 'sf search facets get --format json': changes only what differs now"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 from the 'get' you reviewed; refused (412) if the settings changed since"
        },
        {
          "flags": "--dry-run",
          "description": "check the change and show the result without saving it; needs no --live"
        },
        {
          "flags": "--live",
          "description": "required to save: acknowledge a change every catalog page shows at once"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf items",
      "usage": "sf items",
      "description": "Read and change the item content a StoreFront element renders",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items get",
      "usage": "sf items get",
      "description": "Read an item's attributes, images, title, description, search metadata and tags (item, order and customer; read only, set in the Item Editor)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items attributes",
      "usage": "sf items attributes <file>",
      "description": "Apply a partial attribute update from JSON; an empty string empties a value but keeps the attribute",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items content",
      "usage": "sf items content <file>",
      "description": "Change the item's title or long description; only the fields sent change",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items seo",
      "usage": "sf items seo <file>",
      "description": "Change the item's search metadata; only the fields sent change",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items remove-attribute",
      "usage": "sf items remove-attribute <name>",
      "description": "Remove one attribute that no template declares from the item",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items set-attributes",
      "usage": "sf items set-attributes",
      "description": "Change attributes across many items from a file: a dry run first, then --apply --live writes what it checked",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <file>",
          "description": "CSV or JSON file of changes"
        },
        {
          "flags": "--apply",
          "description": "write the changes the last dry run checked"
        },
        {
          "flags": "--live",
          "description": "required with --apply: acknowledge changing content shoppers see immediately"
        },
        {
          "flags": "--reason <text>",
          "description": "with --apply: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "with --apply: finish the next batch with an approval from an earlier run"
        },
        {
          "flags": "--wait <seconds>",
          "description": "with --apply: how long to wait for each decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items restore-attributes",
      "usage": "sf items restore-attributes <backup>",
      "description": "Put values back from a 'sf items set-attributes' backup: a dry run first, then --apply --live",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--apply",
          "description": "write the values the last dry run checked"
        },
        {
          "flags": "--live",
          "description": "required with --apply: acknowledge changing content shoppers see immediately"
        },
        {
          "flags": "--reason <text>",
          "description": "with --apply: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "with --apply: finish the next batch with an approval from an earlier run"
        },
        {
          "flags": "--wait <seconds>",
          "description": "with --apply: how long to wait for each decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items pricing",
      "usage": "sf items pricing",
      "description": "Read or change what an item charges: price, sale, MSRP and retail volume pricing",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items pricing get",
      "usage": "sf items pricing get",
      "description": "Read the item's price, sale, MSRP and volume pricing, with the hash to change it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items pricing set",
      "usage": "sf items pricing set",
      "description": "Change the item's pricing once the signed-in person approves; only the fields given change",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--cost <amount>",
          "description": "the new price"
        },
        {
          "flags": "--sale-cost <amount>",
          "description": "the sale price; with --sale-start and --sale-end"
        },
        {
          "flags": "--sale-start <iso>",
          "description": "when the sale starts, with an offset"
        },
        {
          "flags": "--sale-end <iso>",
          "description": "when the sale ends, with an offset"
        },
        {
          "flags": "--clear-sale",
          "description": "remove the sale"
        },
        {
          "flags": "--msrp <amount>",
          "description": "the manufacturer suggested retail price"
        },
        {
          "flags": "--clear-msrp",
          "description": "remove the MSRP"
        },
        {
          "flags": "--volume-discounts <file>",
          "description": "JSON file of retail quantity breaks; [] removes them"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the pricing hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing what shoppers pay"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items preorder",
      "usage": "sf items preorder",
      "description": "Read or change whether an item, or its variations, can be bought before it's in stock, and its expected date",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items preorder get",
      "usage": "sf items preorder get",
      "description": "Read the item's pre-order flag, ETA and what shoppers see, with the hash to change them",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--children",
          "description": "read the parent's variations instead, each with its option values and its own hash"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items preorder set",
      "usage": "sf items preorder set",
      "description": "Turn pre-order on or off, or set or clear the ETA, for an item or some of its variations",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--on",
          "description": "turn pre-order on"
        },
        {
          "flags": "--off",
          "description": "turn pre-order off"
        },
        {
          "flags": "--eta <date>",
          "description": "expected availability, YYYY-MM-DD"
        },
        {
          "flags": "--clear-eta",
          "description": "remove the ETA"
        },
        {
          "flags": "--children <names>",
          "description": "comma-separated variations of the parent: option values (2T,3T) or variation item IDs, up to 100"
        },
        {
          "flags": "--dry-run",
          "description": "read and show the plan, and write nothing"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing what shoppers can buy"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items variations",
      "usage": "sf items variations",
      "description": "Read or change a parent item's variations: its axes (Size), their options (2T, 3T) and the child item each combination sells",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items variations get",
      "usage": "sf items variations get",
      "description": "Read the item's axes and options in order (the default marked), each combination with its child, unfilled combinations and the hash",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items variations set",
      "usage": "sf items variations set",
      "description": "Change the item's variations with an ordered list of changes, checked as a whole before any is saved",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--add-axis <Axis=Opt,...>",
          "description": "add an axis, optionally with its options"
        },
        {
          "flags": "--add-option <Axis=Option>",
          "description": "add an option to an axis"
        },
        {
          "flags": "--remove-option <Axis=Option>",
          "description": "remove an option and the combinations using it"
        },
        {
          "flags": "--rename-option <Axis=Option:New>",
          "description": "rename an option"
        },
        {
          "flags": "--reorder <Axis=Opt,...>",
          "description": "put an axis's options in this order"
        },
        {
          "flags": "--default <Axis=Option>",
          "description": "make an option the default (Axis= clears it)"
        },
        {
          "flags": "--set <Axis=Option,...:CHILD[@qty]>",
          "description": "make a combination sell this child item"
        },
        {
          "flags": "--clear <Axis=Option,...[@qty]>",
          "description": "make a combination sell nothing"
        },
        {
          "flags": "--changes <file>",
          "description": "a JSON change list, instead of the verbs"
        },
        {
          "flags": "--dry-run",
          "description": "read and check, show each change and whether it needs approval, and write nothing"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing what shoppers can buy"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items create-child",
      "usage": "sf items create-child",
      "description": "Create a child item from a parent, to sell as one of its variations: copies cost, weight, dimensions, folder and description",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--parent <id>",
          "description": "the parent's merchant item ID"
        },
        {
          "flags": "--parent-oid <oid>",
          "description": "the parent's item OID; pass this or --parent"
        },
        {
          "flags": "--item-id <id>",
          "description": "the new child's merchant item ID"
        },
        {
          "flags": "--description <text>",
          "description": "the child's description (default: the parent's)"
        },
        {
          "flags": "--dry-run",
          "description": "check it and create nothing"
        },
        {
          "flags": "--live",
          "description": "acknowledge creating an item"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items pages",
      "usage": "sf items pages",
      "description": "List the pages an item is on in this storefront, with its default (canonical) page marked and hidden pages noted",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items set-default-page",
      "usage": "sf items set-default-page",
      "description": "Move items' default (canonical) page to another page each is already on: a dry run and plan first, then an approved apply",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <rows>",
          "description": "dry-run these rows and save the plan"
        },
        {
          "flags": "--plan <plan>",
          "description": "apply a plan from --file (with --live)"
        },
        {
          "flags": "--revert <result>",
          "description": "put back the previous defaults from an apply result: writes and dry-runs a new input file"
        },
        {
          "flags": "--live",
          "description": "with --plan: acknowledge changing what shoppers' pages name as canonical"
        },
        {
          "flags": "--reason <text>",
          "description": "with --plan: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "with --plan: finish the next call with an approval from an earlier run"
        },
        {
          "flags": "--wait <seconds>",
          "description": "with --plan: how long to wait for each decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items related",
      "usage": "sf items related",
      "description": "Read or replace an item's related items",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items related get",
      "usage": "sf items related get",
      "description": "Read the item's related items, with the hash to change them",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items related set",
      "usage": "sf items related set [items...]",
      "description": "Replace the item's own related items with these merchant item IDs (ID or ID:addon / ID:complementary)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--none",
          "description": "remove all of the merchant's related items"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the related hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing what shoppers are shown"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items images",
      "usage": "sf items images",
      "description": "Attach, detach or describe the item's images",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items images attach",
      "usage": "sf items images attach <path>",
      "description": "Attach an already uploaded raster image to the item",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--code <code>",
          "description": "named image slot (exclusive with --default)"
        },
        {
          "flags": "--default",
          "description": "the image an itemimage element with no code renders"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        },
        {
          "flags": "--description <text>",
          "description": "image description/alt text"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items images detach",
      "usage": "sf items images detach",
      "description": "Detach an item image; keep the uploaded source file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--code <code>",
          "description": "named image slot (exclusive with --default)"
        },
        {
          "flags": "--default",
          "description": "the image an itemimage element with no code renders"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf items images describe",
      "usage": "sf items images describe",
      "description": "Change one item image's description (alt text) in place; the image itself is not touched",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "merchant item ID, as a storefront carries it"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "item OID; pass this or --item-id, not both"
        },
        {
          "flags": "--image-oid <oid>",
          "description": "the image's merchant_item_multimedia_oid from 'sf items get'"
        },
        {
          "flags": "--code <code>",
          "description": "named image slot (exclusive with --default and --image-oid)"
        },
        {
          "flags": "--default",
          "description": "the image an itemimage element with no code renders"
        },
        {
          "flags": "--description <text>",
          "description": "the new alt text, up to 500 characters"
        },
        {
          "flags": "--clear",
          "description": "remove the description instead"
        },
        {
          "flags": "--current-sha256 <hash>",
          "description": "the description_sha256 you read; refuse if it has changed since"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing content shoppers see immediately"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/items"
    },
    {
      "path": "sf upsells",
      "usage": "sf upsells",
      "description": "Read and manage upsell paths (who is offered what, where in checkout) and upsell offers",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths",
      "usage": "sf upsells paths",
      "description": "Upsell paths: triggers, location, and the variations of offers",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths list",
      "usage": "sf upsells paths list",
      "description": "List the storefront's upsell paths in order, first to last",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--status <status>",
          "description": "current (default, not archived), archived or all"
        },
        {
          "flags": "--location <location>",
          "description": "pre checkout or post checkout"
        },
        {
          "flags": "--search <text>",
          "description": "only paths whose name contains this"
        },
        {
          "flags": "--max-results <n>",
          "description": "page size, 1 to 500 (default 100)"
        },
        {
          "flags": "--offset <n>",
          "description": "offset of the first path"
        },
        {
          "flags": "--stats",
          "description": "include performance stats (runs the stats queries; off by default)"
        },
        {
          "flags": "--from <date>",
          "description": "stats window start, YYYY-MM-DD (with --stats)"
        },
        {
          "flags": "--to <date>",
          "description": "stats window end, YYYY-MM-DD (with --stats; both or neither, neither is the last 30 days)"
        },
        {
          "flags": "--weekdays <days>",
          "description": "only these weekdays, comma separated mon..sun (with --stats)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths get",
      "usage": "sf upsells paths get <oid>",
      "description": "Read one upsell path; --out saves it for editing with a baseline for 'update'",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "local file to create for editing; never overwritten"
        },
        {
          "flags": "--stats",
          "description": "include performance stats (runs the stats queries; off by default)"
        },
        {
          "flags": "--from <date>",
          "description": "stats window start, YYYY-MM-DD (with --stats)"
        },
        {
          "flags": "--to <date>",
          "description": "stats window end, YYYY-MM-DD (with --stats; both or neither, neither is the last 30 days)"
        },
        {
          "flags": "--weekdays <days>",
          "description": "only these weekdays, comma separated mon..sun (with --stats)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths create",
      "usage": "sf upsells paths create <file>",
      "description": "Create an upsell path from a JSON file, and save a baseline beside it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths update",
      "usage": "sf upsells paths update <file>",
      "description": "Replace an upsell path with the file pulled by 'get --out' (or created), checked against its baseline",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths disable",
      "usage": "sf upsells paths disable <oid>",
      "description": "Switch the upsell path off; one that is already off is returned unchanged",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths archive",
      "usage": "sf upsells paths archive <oid>",
      "description": "File the path out of the default list; an archived path does not run",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths unarchive",
      "usage": "sf upsells paths unarchive <oid>",
      "description": "Bring the path back into the default list; a switched-on path is refused (disable, unarchive, then enable)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths move",
      "usage": "sf upsells paths move <oid>",
      "description": "Move the path up, down, to the top or to the bottom of the order",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        },
        {
          "flags": "--to <where>",
          "description": "up, down, top or bottom"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths duplicate",
      "usage": "sf upsells paths duplicate <oid>",
      "description": "Copy the whole path, switched off, right after it; --variation copies one variation into the same path",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        },
        {
          "flags": "--variation <n>",
          "description": "zero-based variation to copy within the path"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells paths enable",
      "usage": "sf upsells paths enable <oid>",
      "description": "Switch the upsell path on once the signed-in person approves; the only way one goes on",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge switching it on for shoppers"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers",
      "usage": "sf upsells offers",
      "description": "Upsell offers: price, schedule, items and rules",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers list",
      "usage": "sf upsells offers list",
      "description": "List the offers on the storefront's paths that are not archived, with their settings",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--stats",
          "description": "include performance stats (runs the stats queries; off by default)"
        },
        {
          "flags": "--from <date>",
          "description": "stats window start, YYYY-MM-DD (with --stats)"
        },
        {
          "flags": "--to <date>",
          "description": "stats window end, YYYY-MM-DD (with --stats; both or neither, neither is the last 30 days)"
        },
        {
          "flags": "--weekdays <days>",
          "description": "only these weekdays, comma separated mon..sun (with --stats)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers get",
      "usage": "sf upsells offers get <oid>",
      "description": "Read one upsell offer; --out saves it for editing with a baseline for 'update'",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "local file to create for editing; never overwritten"
        },
        {
          "flags": "--stats",
          "description": "include performance stats (runs the stats queries; off by default)"
        },
        {
          "flags": "--from <date>",
          "description": "stats window start, YYYY-MM-DD (with --stats)"
        },
        {
          "flags": "--to <date>",
          "description": "stats window end, YYYY-MM-DD (with --stats; both or neither, neither is the last 30 days)"
        },
        {
          "flags": "--weekdays <days>",
          "description": "only these weekdays, comma separated mon..sun (with --stats)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers create",
      "usage": "sf upsells offers create <file>",
      "description": "Create an upsell offer from a JSON file, and save a baseline beside it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers update",
      "usage": "sf upsells offers update <file>",
      "description": "Replace an upsell offer with the file pulled by 'get --out' (or created), checked against its baseline",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers disable",
      "usage": "sf upsells offers disable <oid>",
      "description": "Switch the upsell offer off; one that is already off is returned unchanged",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers duplicate",
      "usage": "sf upsells offers duplicate <oid>",
      "description": "Copy the offer, switched off, with its own copy of the container",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge an upsell write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf upsells offers enable",
      "usage": "sf upsells offers enable <oid>",
      "description": "Switch the upsell offer on once the signed-in person approves; the only way one goes on",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge switching it on for shoppers"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/upsells"
    },
    {
      "path": "sf blog-posts",
      "usage": "sf blog-posts",
      "description": "Find, read, write and illustrate the storefront's blog posts",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts list",
      "usage": "sf blog-posts list",
      "description": "List blog posts, newest first; search matches title, body, excerpt, url part, author or a tag",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "text to search for"
        },
        {
          "flags": "--page <n>",
          "description": "page number, starting at 1"
        },
        {
          "flags": "--page-size <n>",
          "description": "posts per page, 1 to 100 (default 50)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts get",
      "usage": "sf blog-posts get <oid>",
      "description": "Read one blog post in full: body, excerpt, tags, images and where it shows",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts create",
      "usage": "sf blog-posts create <file>",
      "description": "Create a blog post from a JSON file; a draft unless visibility says otherwise",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--body-file <html>",
          "description": "read the body from an HTML file"
        },
        {
          "flags": "--excerpt-file <html>",
          "description": "read the excerpt from an HTML file"
        },
        {
          "flags": "--live",
          "description": "acknowledge creating a public or members-only post"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts update",
      "usage": "sf blog-posts update <oid> <file>",
      "description": "Change a blog post: only the fields in the file change",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--body-file <html>",
          "description": "read the body from an HTML file"
        },
        {
          "flags": "--excerpt-file <html>",
          "description": "read the excerpt from an HTML file"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge changing an existing post, including a draft"
        },
        {
          "flags": "--dry-run",
          "description": "check the change against every rule the write applies and save nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts delete",
      "usage": "sf blog-posts delete <oid>",
      "description": "Take a blog post off every page and delete it once the signed-in person approves; there is no undo",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge deleting an existing post, including a draft"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why this post should go (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts images",
      "usage": "sf blog-posts images",
      "description": "Attach or detach a blog post's images",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts images attach",
      "usage": "sf blog-posts images attach <oid> <image>",
      "description": "Upload a local image and attach it to the post",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--default",
          "description": "make it the post's default image"
        },
        {
          "flags": "--code <code>",
          "description": "attach it under this image code"
        },
        {
          "flags": "--inline",
          "description": "add it for use in the body"
        },
        {
          "flags": "--filename <name>",
          "description": "the image's name in its address (default: the local file name)"
        },
        {
          "flags": "--description <text>",
          "description": "alt text"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge changing an existing post, including a draft"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf blog-posts images detach",
      "usage": "sf blog-posts images detach <oid>",
      "description": "Remove an image from the post; take it out of the body too",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--default",
          "description": "remove the default image"
        },
        {
          "flags": "--code <code>",
          "description": "remove the image with this code"
        },
        {
          "flags": "--image <oid>",
          "description": "remove the image with this blog_post_multimedia_oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge changing an existing post, including a draft"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/blog-posts"
    },
    {
      "path": "sf approvals",
      "usage": "sf approvals",
      "description": "Approvals the signed-in person gives in the UltraCart admin for deletes (list, get, wait, cancel)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf approvals list",
      "usage": "sf approvals list",
      "description": "This sign-in's approvals from the last 24 hours, newest first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "only the approvals for this storefront"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf approvals get",
      "usage": "sf approvals get <id>",
      "description": "One approval: its status, what it covers, and its outcome once used",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf approvals wait",
      "usage": "sf approvals wait <id>",
      "description": "Wait for the person to decide; then re-run the same command with --approval <id>",
      "options": [
        {
          "flags": "--wait <seconds|remaining>",
          "description": "how long to wait before exiting with code 3 (0-600, default 90); remaining uses the request's remaining lifetime, up to 600 seconds"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf approvals cancel",
      "usage": "sf approvals cancel <id>",
      "description": "Withdraw a pending request and free its slot (5 pending per sign-in)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets",
      "usage": "sf secrets",
      "description": "Credentials a person enters in the UltraCart admin, used through handles (kinds, request, get, wait, list, cancel, revoke)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets kinds",
      "usage": "sf secrets kinds",
      "description": "The secret fields (sinks) a handle can be written to, and what each kind of value looks like",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets request",
      "usage": "sf secrets request",
      "description": "Ask a person to enter one or more credentials; prints a handle per value once they do",
      "options": [
        {
          "flags": "--sink <id>",
          "description": "a secret field to collect, from 'sf secrets kinds' (repeatable) (default: [])"
        },
        {
          "flags": "--target <id>",
          "description": "the object the value is for: a Twilio account SID (AC...) or a sending domain (required by some fields)"
        },
        {
          "flags": "--keys <a,b,...>",
          "description": "bulk: one handle per key, each key its handle's target (such as sending domains)"
        },
        {
          "flags": "--keys-from <file>",
          "description": "bulk: keys from a file, one per line"
        },
        {
          "flags": "--label <text>",
          "description": "a short name the person sees, marked unverified (120 characters)"
        },
        {
          "flags": "--reason <text>",
          "description": "why it is needed, shown to the person marked unverified (500 characters)"
        },
        {
          "flags": "--ttl <duration>",
          "description": "how long each handle stays usable once entered, 60s to 24h (default 1h)"
        },
        {
          "flags": "--uses <n>",
          "description": "how many writes each handle may make, 1 to 100 (default 1)"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait before exiting with code 3 (0-600, default 90)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets get",
      "usage": "sf secrets get <id>",
      "description": "One secret request: its status and each handle's status and fingerprint (never a value)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets wait",
      "usage": "sf secrets wait <id>",
      "description": "Wait for the person to enter the values; prints the handles once they do",
      "options": [
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait before exiting with code 3 (0-600, default 90)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets list",
      "usage": "sf secrets list",
      "description": "This sign-in's secret requests from the last 24 hours, newest first (without handles)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets cancel",
      "usage": "sf secrets cancel <id>",
      "description": "Withdraw a request nobody has filled in yet, with its handles",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf secrets revoke",
      "usage": "sf secrets revoke <id>",
      "description": "Revoke a filled-in request's handles that no write has used, so their values can never be written",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf comms",
      "usage": "sf comms",
      "description": "The account's Twilio account, sending domains and plan, the storefront's Communications settings, templates and providers, its campaigns, flows, lists and segments, their statistics, rendering an email or proofing a postcard without sending it, and test sends to a user on the account",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms twilio",
      "usage": "sf comms twilio",
      "description": "The account's Twilio account, for SMS and the phone system (get, create, update, delete)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms twilio get",
      "usage": "sf comms twilio get",
      "description": "The Twilio account, with the auth token masked; twilio_account is null when there is none",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms twilio create",
      "usage": "sf comms twilio create",
      "description": "Connect the Twilio account: its SID and an auth token from a handle or @request",
      "options": [
        {
          "flags": "--account-sid <sid>",
          "description": "the Twilio account SID (AC followed by 32 hex digits)"
        },
        {
          "flags": "--auth-token <handle>",
          "description": "a secret handle made for this account SID, or @request"
        },
        {
          "flags": "--phone-number <e164>",
          "description": "a phone number UltraCart uses, such as +15555550100 (repeatable) (default: [])"
        },
        {
          "flags": "--reason <text>",
          "description": "for @request: one sentence for the person, shown as unverified"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person, for @request and for an approval, before exiting with code 3 (0-600, default 90)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms twilio update",
      "usage": "sf comms twilio update",
      "description": "Change the Twilio account: a new auth token, a new account (SID and token), or its phone numbers",
      "options": [
        {
          "flags": "--account-sid <sid>",
          "description": "a different Twilio account SID; needs --auth-token for it"
        },
        {
          "flags": "--auth-token <handle>",
          "description": "a secret handle made for the account SID, or @request"
        },
        {
          "flags": "--phone-number <e164>",
          "description": "replaces the phone numbers UltraCart uses with these (repeatable) (default: [])"
        },
        {
          "flags": "--reason <text>",
          "description": "for @request: one sentence for the person, shown as unverified"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person, for @request and for an approval, before exiting with code 3 (0-600, default 90)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms twilio delete",
      "usage": "sf comms twilio delete",
      "description": "Remove the Twilio account from UltraCart once the signed-in person approves; it stays at Twilio",
      "options": [
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why it should go (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains",
      "usage": "sf comms domains",
      "description": "The account's sending domains (list, get, status, create, update, delete)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains list",
      "usage": "sf comms domains list",
      "description": "Every sending domain, with its provider, verification and DNS records; Mailgun keys masked",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains get",
      "usage": "sf comms domains get <domain>",
      "description": "One sending domain as stored",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains status",
      "usage": "sf comms domains status <domain>",
      "description": "Check an amazon domain's DNS records again with Amazon SES (restarts a verification that failed)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains create",
      "usage": "sf comms domains create <domain>",
      "description": "Add a sending domain: amazon (publish the DNS records it returns) or mailgun (with its API key)",
      "options": [
        {
          "flags": "--provider <name>",
          "description": "amazon or mailgun"
        },
        {
          "flags": "--api-key <handle>",
          "description": "mailgun only: a secret handle made for this domain, or @request"
        },
        {
          "flags": "--reason <text>",
          "description": "for @request: one sentence for the person, shown as unverified"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person, for @request and for an approval, before exiting with code 3 (0-600, default 90)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains update",
      "usage": "sf comms domains update <domain>",
      "description": "Replace a mailgun domain's API key",
      "options": [
        {
          "flags": "--api-key <handle>",
          "description": "a secret handle made for this domain, or @request"
        },
        {
          "flags": "--reason <text>",
          "description": "for @request: one sentence for the person, shown as unverified"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person, for @request and for an approval, before exiting with code 3 (0-600, default 90)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms domains delete",
      "usage": "sf comms domains delete <domain>",
      "description": "Remove a sending domain from UltraCart once the signed-in person approves",
      "options": [
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why it should go (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns",
      "usage": "sf comms campaigns",
      "description": "Campaigns, each with its emails and postcards in step order (list, get, create, update, archive, unarchive, clone)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns list",
      "usage": "sf comms campaigns list",
      "description": "The storefront's campaigns, newest first, with their emails and postcards",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "only those whose name contains this text"
        },
        {
          "flags": "--page <n>",
          "description": "page number, from 1"
        },
        {
          "flags": "--page-size <n>",
          "description": "how many per page, 1 to 100 (default 50)"
        },
        {
          "flags": "--include-archived",
          "description": "include archived campaigns, which carry deleted: true"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns get",
      "usage": "sf comms campaigns get <campaign_uuid>",
      "description": "One campaign, the same as its list entry, with its emails and postcards",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns create",
      "usage": "sf comms campaigns create",
      "description": "Create a draft campaign with no emails yet; nothing here starts it",
      "options": [
        {
          "flags": "--name <text>",
          "description": "the campaign name, 1 to 250 characters (required)"
        },
        {
          "flags": "--sending-domain <uuid>",
          "description": "the sending domain uuid, from 'sf comms domains list' (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-user <name>",
          "description": "the from address before the @ (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-name <text>",
          "description": "the from name (default: the storefront's marketing setting)"
        },
        {
          "flags": "--end-on-purchase",
          "description": "end it for a customer once they buy from one of its emails"
        },
        {
          "flags": "--no-end-on-purchase",
          "description": "don't end it when a customer buys from one of its emails"
        },
        {
          "flags": "--end-on-any-purchase",
          "description": "end it for a customer once they buy from any source"
        },
        {
          "flags": "--no-end-on-any-purchase",
          "description": "don't end it when a customer buys from another source"
        },
        {
          "flags": "--folder <uuid>",
          "description": "file it in this campaign folder, from 'sf comms campaigns folders list'"
        },
        {
          "flags": "--list <uuid>",
          "description": "send to this list, from 'sf comms lists list'; repeatable. Any list or segment flag replaces the whole audience (default: [])"
        },
        {
          "flags": "--exclude-list <uuid>",
          "description": "leave out this list's members; repeatable (default: [])"
        },
        {
          "flags": "--segment <uuid>",
          "description": "send to this segment, from 'sf comms segments list'; repeatable (default: [])"
        },
        {
          "flags": "--exclude-segment <uuid>",
          "description": "leave out this segment's members; repeatable (default: [])"
        },
        {
          "flags": "--schedule <iso>",
          "description": "when to send once it is started in the admin, in the future (ISO 8601)"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--dry-run",
          "description": "check the inputs, show the campaign that would be created, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns update",
      "usage": "sf comms campaigns update <campaign_uuid>",
      "description": "Change a campaign; a flag left out keeps its value",
      "options": [
        {
          "flags": "--name <text>",
          "description": "the campaign name, 1 to 250 characters"
        },
        {
          "flags": "--sending-domain <uuid>",
          "description": "the sending domain uuid, from 'sf comms domains list' (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-user <name>",
          "description": "the from address before the @ (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-name <text>",
          "description": "the from name (default: the storefront's marketing setting)"
        },
        {
          "flags": "--end-on-purchase",
          "description": "end it for a customer once they buy from one of its emails"
        },
        {
          "flags": "--no-end-on-purchase",
          "description": "don't end it when a customer buys from one of its emails"
        },
        {
          "flags": "--end-on-any-purchase",
          "description": "end it for a customer once they buy from any source"
        },
        {
          "flags": "--no-end-on-any-purchase",
          "description": "don't end it when a customer buys from another source"
        },
        {
          "flags": "--folder <uuid>",
          "description": "file it in this campaign folder, from 'sf comms campaigns folders list'"
        },
        {
          "flags": "--clear-folder",
          "description": "take it out of its campaign folder"
        },
        {
          "flags": "--list <uuid>",
          "description": "send to this list, from 'sf comms lists list'; repeatable. Any list or segment flag replaces the whole audience (default: [])"
        },
        {
          "flags": "--exclude-list <uuid>",
          "description": "leave out this list's members; repeatable (default: [])"
        },
        {
          "flags": "--segment <uuid>",
          "description": "send to this segment, from 'sf comms segments list'; repeatable (default: [])"
        },
        {
          "flags": "--exclude-segment <uuid>",
          "description": "leave out this segment's members; repeatable (default: [])"
        },
        {
          "flags": "--schedule <iso>",
          "description": "when to send once it is started in the admin, in the future (ISO 8601)"
        },
        {
          "flags": "--clear-audience",
          "description": "remove every list and segment"
        },
        {
          "flags": "--clear-schedule",
          "description": "remove the send time"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required when the campaign is live: acknowledge a change customers get"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read it, show what would change and what the change would need, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns archive",
      "usage": "sf comms campaigns archive <campaign_uuid>",
      "description": "Archive a campaign; a scheduled one is set back to draft so it won't send, and one already sending is refused",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required when the campaign is live"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read it, show what would change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns unarchive",
      "usage": "sf comms campaigns unarchive <campaign_uuid>",
      "description": "Unarchive a campaign",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required when the campaign is live"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read it, show what would change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns clone",
      "usage": "sf comms campaigns clone <campaign_uuid>",
      "description": "Copy a campaign on the same storefront, with its own copies of its emails and postcards, as a draft",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--dry-run",
          "description": "read the campaign that would be copied, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns folders",
      "usage": "sf comms campaigns folders",
      "description": "Campaign folders: list them, read one with what it holds, create, rename or delete one (list, get, create, update, delete)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns folders list",
      "usage": "sf comms campaigns folders list",
      "description": "The storefront's campaign folders by name, each with how many campaigns it holds",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns folders get",
      "usage": "sf comms campaigns folders get <folder_uuid>",
      "description": "One campaign folder, with the name and uuid of each campaign in it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns folders create",
      "usage": "sf comms campaigns folders create",
      "description": "Create an empty campaign folder; file a campaign in it with its update's --folder",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the folder name (at most 250 characters)"
        },
        {
          "flags": "--dry-run",
          "description": "check the name, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns folders update",
      "usage": "sf comms campaigns folders update <folder_uuid>",
      "description": "Rename a campaign folder; one the system made can't be renamed",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the new name (at most 250 characters)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the folder's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the folder, show the change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms campaigns folders delete",
      "usage": "sf comms campaigns folders delete <folder_uuid>",
      "description": "Delete a campaign folder; its campaigns are kept, filed under no folder, and named in moved",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the folder's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the folder, name the campaigns that would move to no folder, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows",
      "usage": "sf comms flows",
      "description": "Flows, each with its trigger and its emails and postcards in step order (list, get, create, update, archive, unarchive, clone, activate, deactivate)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows list",
      "usage": "sf comms flows list",
      "description": "The storefront's flows, newest first, with their emails and postcards",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "only those whose name contains this text"
        },
        {
          "flags": "--page <n>",
          "description": "page number, from 1"
        },
        {
          "flags": "--page-size <n>",
          "description": "how many per page, 1 to 100 (default 50)"
        },
        {
          "flags": "--include-archived",
          "description": "include archived flows, which carry deleted: true"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows get",
      "usage": "sf comms flows get <flow_uuid>",
      "description": "One flow, the same as its list entry, with its emails and postcards",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows create",
      "usage": "sf comms flows create",
      "description": "Create a draft flow with no steps yet; it enrolls nobody until it is turned on",
      "options": [
        {
          "flags": "--name <text>",
          "description": "the flow name, 1 to 250 characters (required)"
        },
        {
          "flags": "--sending-domain <uuid>",
          "description": "the sending domain uuid, from 'sf comms domains list' (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-user <name>",
          "description": "the from address before the @ (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-name <text>",
          "description": "the from name (default: the storefront's marketing setting)"
        },
        {
          "flags": "--end-on-purchase",
          "description": "end it for a customer once they buy from one of its emails"
        },
        {
          "flags": "--no-end-on-purchase",
          "description": "don't end it when a customer buys from one of its emails"
        },
        {
          "flags": "--end-on-any-purchase",
          "description": "end it for a customer once they buy from any source"
        },
        {
          "flags": "--no-end-on-any-purchase",
          "description": "don't end it when a customer buys from another source"
        },
        {
          "flags": "--folder <uuid>",
          "description": "file it in this flow folder, from 'sf comms flows folders list'"
        },
        {
          "flags": "--trigger <type>",
          "description": "what enrolls a customer, such as \"cart:abandoned\" (required); see --help for the list"
        },
        {
          "flags": "--trigger-parameter <uuid>",
          "description": "the list or segment uuid, for a list or segment trigger"
        },
        {
          "flags": "--multiple-enrollments",
          "description": "let a customer be in the flow more than once at a time"
        },
        {
          "flags": "--no-multiple-enrollments",
          "description": "allow one enrollment at a time"
        },
        {
          "flags": "--reentry <policy>",
          "description": "whether a customer may enter again: anytime, after_days or never"
        },
        {
          "flags": "--reentry-days <n>",
          "description": "days before a customer may enter again, 1 to 1095, with --reentry after_days"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--dry-run",
          "description": "check the inputs, show the flow that would be created, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows update",
      "usage": "sf comms flows update <flow_uuid>",
      "description": "Change a flow; a flag left out keeps its value",
      "options": [
        {
          "flags": "--name <text>",
          "description": "the flow name, 1 to 250 characters"
        },
        {
          "flags": "--sending-domain <uuid>",
          "description": "the sending domain uuid, from 'sf comms domains list' (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-user <name>",
          "description": "the from address before the @ (default: the storefront's marketing setting)"
        },
        {
          "flags": "--sending-name <text>",
          "description": "the from name (default: the storefront's marketing setting)"
        },
        {
          "flags": "--end-on-purchase",
          "description": "end it for a customer once they buy from one of its emails"
        },
        {
          "flags": "--no-end-on-purchase",
          "description": "don't end it when a customer buys from one of its emails"
        },
        {
          "flags": "--end-on-any-purchase",
          "description": "end it for a customer once they buy from any source"
        },
        {
          "flags": "--no-end-on-any-purchase",
          "description": "don't end it when a customer buys from another source"
        },
        {
          "flags": "--folder <uuid>",
          "description": "file it in this flow folder, from 'sf comms flows folders list'"
        },
        {
          "flags": "--clear-folder",
          "description": "take it out of its flow folder"
        },
        {
          "flags": "--trigger <type>",
          "description": "change what enrolls a customer, only while the flow is off; see --help for the list"
        },
        {
          "flags": "--trigger-parameter <uuid>",
          "description": "the list or segment uuid for a list or segment trigger; left out, the flow keeps its own when the type doesn't change"
        },
        {
          "flags": "--multiple-enrollments",
          "description": "let a customer be in the flow more than once at a time"
        },
        {
          "flags": "--no-multiple-enrollments",
          "description": "allow one enrollment at a time"
        },
        {
          "flags": "--reentry <policy>",
          "description": "whether a customer may enter again: anytime, after_days or never"
        },
        {
          "flags": "--reentry-days <n>",
          "description": "days before a customer may enter again, 1 to 1095, with --reentry after_days"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required when the flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read it, show what would change and what the change would need, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows archive",
      "usage": "sf comms flows archive <flow_uuid>",
      "description": "Archive a flow; one that is still on is refused: turn it off first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required when the flow is live"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read it, show what would change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows unarchive",
      "usage": "sf comms flows unarchive <flow_uuid>",
      "description": "Unarchive a flow",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required when the flow is live"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read it, show what would change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows clone",
      "usage": "sf comms flows clone <flow_uuid>",
      "description": "Copy a flow on the same storefront, with its own copies of its emails and postcards, as a draft",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--dry-run",
          "description": "read the flow that would be copied, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows folders",
      "usage": "sf comms flows folders",
      "description": "Flow folders: list them, read one with what it holds, create, rename or delete one (list, get, create, update, delete)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows folders list",
      "usage": "sf comms flows folders list",
      "description": "The storefront's flow folders by name, each with how many flows it holds",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows folders get",
      "usage": "sf comms flows folders get <folder_uuid>",
      "description": "One flow folder, with the name and uuid of each flow in it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows folders create",
      "usage": "sf comms flows folders create",
      "description": "Create an empty flow folder; file a flow in it with its update's --folder",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the folder name (at most 250 characters)"
        },
        {
          "flags": "--dry-run",
          "description": "check the name, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows folders update",
      "usage": "sf comms flows folders update <folder_uuid>",
      "description": "Rename a flow folder; one the system made can't be renamed",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the new name (at most 250 characters)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the folder's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the folder, show the change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows folders delete",
      "usage": "sf comms flows folders delete <folder_uuid>",
      "description": "Delete a flow folder; its flows are kept, filed under no folder, and named in moved",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the folder's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the folder, name the flows that would move to no folder, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows backfill",
      "usage": "sf comms flows backfill <flow_uuid>",
      "description": "Enroll and mail past customers who would have met a live flow's trigger; --dry-run counts them, a real run needs --live and the signed-in person's approval",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--days <n>",
          "description": "for an order trigger, how many days of past orders, 1 to 90 (default 5)"
        },
        {
          "flags": "--relative-to-event",
          "description": "time each customer's first wait from their order or segment date, not from now"
        },
        {
          "flags": "--live",
          "description": "required: past customers are enrolled and mailed, and it can't be undone from here"
        },
        {
          "flags": "--dry-run",
          "description": "count the customers it would enroll, and enroll nobody"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving, why this backfill should run (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows activate",
      "usage": "sf comms flows activate <flow_uuid>",
      "description": "Turn a flow on: customers who trigger it from now on are enrolled and get its emails",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge that this changes which customers get its emails"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the flow, show the change and what it would need, and write nothing; it can't check that the flow is ready"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms flows deactivate",
      "usage": "sf comms flows deactivate <flow_uuid>",
      "description": "Turn a flow off: no new customers are enrolled",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge that this changes which customers get its emails"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the flow, show the change and what it would need, and write nothing; it can't check that the flow is ready"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists",
      "usage": "sf comms lists",
      "description": "Email lists, for a campaign's audience or a list trigger: list them, read one with who uses it, create one, change its name, folder or public settings, or archive it (list, get, create, update, archive)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists list",
      "usage": "sf comms lists list",
      "description": "The storefront's email lists by name: uuid, name and member count, never the members",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists get",
      "usage": "sf comms lists get <list_uuid>",
      "description": "One list: name, folder, member count, public settings, and the campaigns and flows that use it; never its members",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists create",
      "usage": "sf comms lists create",
      "description": "Create an empty list",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the list name (at most 250 characters)"
        },
        {
          "flags": "--folder <uuid>",
          "description": "a list and segment folder on this storefront, from 'sf comms folders list'"
        },
        {
          "flags": "--public",
          "description": "offer the list on the storefront's email preferences page"
        },
        {
          "flags": "--no-public",
          "description": "don't offer it there (the default)"
        },
        {
          "flags": "--public-description <text>",
          "description": "plain text subscribers see for a public list, at most 100 characters"
        },
        {
          "flags": "--dry-run",
          "description": "check the inputs, show the list, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists update",
      "usage": "sf comms lists update <list_uuid>",
      "description": "Change a list's name, folder or public settings; its members are never changed here",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "a new name (at most 250 characters)"
        },
        {
          "flags": "--folder <uuid>",
          "description": "file it in this list and segment folder"
        },
        {
          "flags": "--clear-folder",
          "description": "take it out of its folder"
        },
        {
          "flags": "--public",
          "description": "offer the list on the storefront's email preferences page"
        },
        {
          "flags": "--no-public",
          "description": "stop offering it there"
        },
        {
          "flags": "--public-description <text>",
          "description": "plain text subscribers see for a public list, at most 100 characters"
        },
        {
          "flags": "--clear-public-description",
          "description": "remove the public description"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the list's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the list, show what would change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists archive",
      "usage": "sf comms lists archive <list_uuid>",
      "description": "Archive a list, keeping its members; refused while a live campaign or flow uses it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--even-if-used",
          "description": "archive it although a campaign or flow that isn't live uses it; that one can no longer use the list"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the list's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the list, show who uses it and what the archive would need, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lists members",
      "usage": "sf comms lists members <list_uuid>",
      "description": "Who is on the list, a page at a time: customer uuid, email (masked) and when they joined",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--page <n>",
          "description": "the page, from 1"
        },
        {
          "flags": "--page-size <n>",
          "description": "members per page, 1 to 100 (default 50)"
        },
        {
          "flags": "--show-customer-data",
          "description": "return real names, email addresses and street addresses instead of masked ones. This puts them into this transcript: use it only when the merchant asks for a person's details, and never paste them into issues, chats or commits. Needs a profile with publish permission; the server logs every such read"
        },
        {
          "flags": "--audit-log <file>",
          "description": "append one JSON line per read to this file: what was read and how many rows, never a customer value"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments",
      "usage": "sf comms segments",
      "description": "Customer segments, for a campaign's audience or a segment trigger: list them, read one with its rule, create one, change its name, rule or folder, archive it, read its members, or look up what a rule function takes (list, get, create, update, archive, members, functions)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments list",
      "usage": "sf comms segments list",
      "description": "The storefront's segments by name: uuid, name and member count at the last rebuild, never the members or the rule",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments get",
      "usage": "sf comms segments get <segment_uuid>",
      "description": "One segment: name, folder, rule, member count at the last rebuild, whether a rebuild is due, and the campaigns and flows that use it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments create",
      "usage": "sf comms segments create",
      "description": "Create a segment from a name and a rule; it starts empty and rebuilds in the background",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the segment name (at most 100 characters)"
        },
        {
          "flags": "--filter <file>",
          "description": "a JSON file holding the rule, in the shape 'sf comms segments get' shows filter_profile_equation"
        },
        {
          "flags": "--folder <uuid>",
          "description": "a list and segment folder on this storefront"
        },
        {
          "flags": "--dry-run",
          "description": "check the inputs, show the segment, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments update",
      "usage": "sf comms segments update <segment_uuid>",
      "description": "Change a segment's name, rule or folder; a new rule for a segment a live campaign or flow uses is approved by the signed-in person first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "a new name (at most 100 characters)"
        },
        {
          "flags": "--filter <file>",
          "description": "a JSON file holding the new rule, in the shape 'sf comms segments get' shows filter_profile_equation"
        },
        {
          "flags": "--folder <uuid>",
          "description": "file it in this list and segment folder"
        },
        {
          "flags": "--clear-folder",
          "description": "take it out of its folder"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the segment's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when a live campaign or flow uses the segment and the rule changes: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read the segment, show what would change and who uses it, and write nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "for a rule in live use: one sentence for the person approving, why the audience should change (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments archive",
      "usage": "sf comms segments archive <segment_uuid>",
      "description": "Archive a segment; refused while a live campaign or flow uses it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--even-if-used",
          "description": "archive it although a campaign or flow that isn't live uses it; that one can no longer use the segment"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the segment's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the segment, show who uses it and what the archive would need, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments members",
      "usage": "sf comms segments members <segment_uuid>",
      "description": "Who is in the segment, a page at a time: customer uuid, email (masked) and when they joined",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--page <n>",
          "description": "the page, from 1"
        },
        {
          "flags": "--page-size <n>",
          "description": "members per page, 1 to 100 (default 50)"
        },
        {
          "flags": "--show-customer-data",
          "description": "return real names, email addresses and street addresses instead of masked ones. This puts them into this transcript: use it only when the merchant asks for a person's details, and never paste them into issues, chats or commits. Needs a profile with publish permission; the server logs every such read"
        },
        {
          "flags": "--audit-log <file>",
          "description": "append one JSON line per read to this file: what was read and how many rows, never a customer value"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms segments functions",
      "usage": "sf comms segments functions",
      "description": "The rule functions a segment or step filter can use: each function's fields and, where the admin picks from a fixed list, the values it saves (no sign-in needed)",
      "options": [
        {
          "flags": "--type <type>",
          "description": "one function, by its type"
        },
        {
          "flags": "--storefront <oid>",
          "description": "accepted and ignored: the functions are the same on every storefront"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms folders",
      "usage": "sf comms folders",
      "description": "List and segment folders: list them, read one with what it holds, create, rename or delete one (list, get, create, update, delete)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms folders list",
      "usage": "sf comms folders list",
      "description": "The storefront's list and segment folders by name, each with how many lists and segments it holds",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms folders get",
      "usage": "sf comms folders get <folder_uuid>",
      "description": "One folder, with the name and uuid of each list and segment in it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms folders create",
      "usage": "sf comms folders create",
      "description": "Create an empty folder; file a list or segment in it with its --folder",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the folder name (at most 250 characters)"
        },
        {
          "flags": "--dry-run",
          "description": "check the name, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms folders update",
      "usage": "sf comms folders update <folder_uuid>",
      "description": "Rename a folder; one the system made can't be renamed",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the new name (at most 250 characters)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the folder's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the folder, show the change, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms folders delete",
      "usage": "sf comms folders delete <folder_uuid>",
      "description": "Delete a folder; its lists and segments are kept, filed under no folder, and named in moved",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the folder's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--dry-run",
          "description": "read the folder, name the lists and segments that would move to no folder, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences",
      "usage": "sf comms sequences",
      "description": "A campaign's or flow's steps, as a tree, one step's dispatch log and counts, one step's settings or filter, new email, wait, split, condition and postcard steps, moving and removing a step (get, dispatch-logs, set-config, set-filter, add-email, add-wait, add-split, add-condition, add-postcard, move-step, remove-step, stats, test-sms)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences get",
      "usage": "sf comms sequences get <sequence_uuid>",
      "description": "A campaign's or flow's steps in order: each step's type, label, settings and audience filter, the emails, postcard, lists or items it names, and the branches of a condition, split or InboxGeek step",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--waiting",
          "description": "also show how many customers are waiting on each step now"
        },
        {
          "flags": "--mermaid",
          "description": "instead of the tree, a Mermaid flowchart of the steps in a mermaid field, for showing the merchant"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences dispatch-logs",
      "usage": "sf comms sequences dispatch-logs <sequence_uuid>",
      "description": "Why a step sent, skipped or ended each customer who reached it, newest first, with the step's counts (read only)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the step to read, from 'sf comms sequences get'"
        },
        {
          "flags": "--since <window>",
          "description": "how far back: 15m, 2h, 7d or an ISO-8601 time with an offset (default 7d, at most 90d)"
        },
        {
          "flags": "--limit <n>",
          "description": "most entries to return, 1 to 200 (default 50)"
        },
        {
          "flags": "--offset <n>",
          "description": "the next page: next_offset from the previous answer, sent with that answer's since"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences set-config",
      "usage": "sf comms sequences set-config <sequence_uuid>",
      "description": "Change one step's settings, and nothing else about the step or the sequence",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the step to change, from 'sf comms sequences get'"
        },
        {
          "flags": "--set <key=value>",
          "description": "set one settings key; repeat for several. A value that parses as JSON is used as JSON, anything else as text; a key the step already stores as text stays text (default: [])"
        },
        {
          "flags": "--unset <key>",
          "description": "remove one settings key; repeat for several (default: [])"
        },
        {
          "flags": "--config <file>",
          "description": "replace the whole settings object with this JSON file, instead of --set and --unset"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the step's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--allow-unknown-keys",
          "description": "report a key neither the admin nor the send code knows as a warning instead of refusing it"
        },
        {
          "flags": "--dry-run",
          "description": "read and check the change, show it, and write nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "when turning a postcard step on: one sentence for the person approving, why (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences set-filter",
      "usage": "sf comms sequences set-filter <sequence_uuid>",
      "description": "Change one step's audience filter, and nothing else about the step or the sequence",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the step to change, from 'sf comms sequences get'"
        },
        {
          "flags": "--filter <file>",
          "description": "the new filter as a JSON file, in the shape 'sf comms sequences get' shows filter_profile_equation; {} removes it. A function type outside the segment types is refused before anything is sent, and the dry run shows the filter as sentences (before_text, after_text). The server checks it as a segment rule (groups, function types, a plain project.dataset.table for Is in BigQuery, lists and segments on this storefront) and refuses it with validation_failed and a message naming the place"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the step's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read and check the change, show it, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences add-email",
      "usage": "sf comms sequences add-email <sequence_uuid>",
      "description": "Add an email step, with its new email, after a step, first on one side of a condition, split or InboxGeek step, or as the first step of a new campaign or flow",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--after <step_uuid>",
          "description": "the step the new email step follows, in the same list, from 'sf comms sequences get'"
        },
        {
          "flags": "--branch <step_uuid>",
          "description": "a condition, split or InboxGeek step: with --side, the new step goes first on that side"
        },
        {
          "flags": "--side <label>",
          "description": "with --branch: the side's label from 'sf comms sequences get' (yes or no, left or right)"
        },
        {
          "flags": "--subject <text>",
          "description": "the new email's subject line, 5 to 150 characters (required unless --from-library gives one)"
        },
        {
          "flags": "--preview-text <text>",
          "description": "the new email's preview text, 5 to 150 characters (required unless --from-library gives one)"
        },
        {
          "flags": "--from-library <library_item_oid>",
          "description": "start the email from a code-library email item, from 'sf comms library emails': its body, subject and preview text"
        },
        {
          "flags": "--acknowledge-executable",
          "description": "with --from-library: add an item whose body has script, html, embed, css or velocity elements, once the merchant has checked it"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read of the --after or --branch step, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read and check where the step goes, show it, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences add-wait",
      "usage": "sf comms sequences add-wait <sequence_uuid>",
      "description": "Add a wait step after a step, first on one side of a condition, split or InboxGeek step, or as the first step of a new campaign or flow",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--after <step_uuid>",
          "description": "the step the new wait follows, in the same list, from 'sf comms sequences get'"
        },
        {
          "flags": "--branch <step_uuid>",
          "description": "a condition, split or InboxGeek step: with --side, the new wait goes first on that side"
        },
        {
          "flags": "--side <label>",
          "description": "with --branch: the side's label from 'sf comms sequences get' (yes or no, left or right)"
        },
        {
          "flags": "--minutes <n>",
          "description": "wait this many minutes (give exactly one of the unit options)"
        },
        {
          "flags": "--hours <n>",
          "description": "wait this many hours"
        },
        {
          "flags": "--days <n>",
          "description": "wait this many days"
        },
        {
          "flags": "--weeks <n>",
          "description": "wait this many weeks"
        },
        {
          "flags": "--months <n>",
          "description": "wait this many months"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read of the --after or --branch step, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read and check where the step goes, show it, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences add-split",
      "usage": "sf comms sequences add-split <sequence_uuid>",
      "description": "Add a split, which sends a share of customers left and the rest right, after a step, first on one side of a condition, split or InboxGeek step, or as the first step of a new campaign or flow",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--after <step_uuid>",
          "description": "the step the new split follows, in the same list, from 'sf comms sequences get'"
        },
        {
          "flags": "--branch <step_uuid>",
          "description": "a condition, split or InboxGeek step: with --side, the new split goes first on that side"
        },
        {
          "flags": "--side <label>",
          "description": "with --branch: the side's label from 'sf comms sequences get' (yes or no, left or right)"
        },
        {
          "flags": "--percentage-left <share>",
          "description": "the share of customers sent left, 0.01 to 0.99 (default 0.5)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read of the --after or --branch step, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read and check where the step goes, show it, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences add-condition",
      "usage": "sf comms sequences add-condition <sequence_uuid>",
      "description": "Add a condition, which sends customers matching a rule down yes and the rest down no, after a step, first on one side of a condition, split or InboxGeek step, or as the first step of a new campaign or flow",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--filter <file>",
          "description": "the rule as a JSON file, in the shape 'sf comms sequences get' shows filter_profile_equation, with at least one group; checked as set-filter checks a filter before anything is sent"
        },
        {
          "flags": "--after <step_uuid>",
          "description": "the step the new condition follows, in the same list, from 'sf comms sequences get'"
        },
        {
          "flags": "--branch <step_uuid>",
          "description": "a condition, split or InboxGeek step: with --side, the new condition goes first on that side"
        },
        {
          "flags": "--side <label>",
          "description": "with --branch: the side's label from 'sf comms sequences get' (yes or no, left or right)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read of the --after or --branch step, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read and check where the step goes and the rule, show them (the rule as sentences too), and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences add-postcard",
      "usage": "sf comms sequences add-postcard <sequence_uuid>",
      "description": "Add a postcard step, off, with its postcard's default front and back, after a step, first on one side of a condition, split or InboxGeek step, or as the first step of a new campaign or flow",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--after <step_uuid>",
          "description": "the step the new postcard step follows, in the same list, from 'sf comms sequences get'"
        },
        {
          "flags": "--branch <step_uuid>",
          "description": "a condition, split or InboxGeek step: with --side, the new step goes first on that side"
        },
        {
          "flags": "--side <label>",
          "description": "with --branch: the side's label from 'sf comms sequences get' (yes or no, left or right)"
        },
        {
          "flags": "--name <text>",
          "description": "the step's name in the admin, one line of 1 to 100 characters (default: Postcard)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read of the --after or --branch step, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "read and check where the step goes, show it, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences move-step",
      "usage": "sf comms sequences move-step <sequence_uuid>",
      "description": "Move one step to after another step, first on one side of a condition, split or InboxGeek step, or first in the sequence, keeping its email or postcard; a live campaign or flow's move is approved by the signed-in person first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the step to move, from 'sf comms sequences get'"
        },
        {
          "flags": "--after <step_uuid>",
          "description": "the step it goes right after, in that step's list"
        },
        {
          "flags": "--branch <step_uuid>",
          "description": "a condition, split or InboxGeek step: with --side, the step goes first on that side"
        },
        {
          "flags": "--side <label>",
          "description": "with --branch: the side's label from 'sf comms sequences get' (yes or no, left or right)"
        },
        {
          "flags": "--first",
          "description": "put it first in the sequence, right after begin"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the moved step's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "check the move, show where it goes from and to, and write nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "for a live sequence: one sentence for the person approving, why this step should move (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences remove-step",
      "usage": "sf comms sequences remove-step <sequence_uuid>",
      "description": "Remove one step, archiving the email or postcard it sent; a live campaign or flow's removal is approved by the signed-in person first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the step to remove, from 'sf comms sequences get'"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the step's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required when the campaign or flow is live: acknowledge a change customers get"
        },
        {
          "flags": "--dry-run",
          "description": "check the removal, show what would go, and write nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "for a live sequence: one sentence for the person approving, why this step should go (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences stats",
      "usage": "sf comms sequences stats <sequence_uuid>",
      "description": "A campaign's or flow's statistics: all time overall, and each step's (each variant and branch) over --days (read only)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--days <n>",
          "description": "how many days back the per-step counts cover, 1 to 365 (default 30)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms sequences test-sms",
      "usage": "sf comms sequences test-sms <sequence_uuid>",
      "description": "Send one test of an SMS step to a user's cell phone; always --live, and billed per segment",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the SMS step, from 'sf comms sequences get'"
        },
        {
          "flags": "--to-phone <e164>",
          "description": "the cell phone of a user on this account, such as +14045550100"
        },
        {
          "flags": "--live",
          "description": "required: it goes to a real phone and is billed per segment"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails",
      "usage": "sf comms emails",
      "description": "Flow and campaign emails (get, update, request-review, render, clicks, test)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails get",
      "usage": "sf comms emails get <email_uuid>",
      "description": "A flow or campaign email's subject and preview text, with its hash_sha256, whether it is live, and its review state",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails update",
      "usage": "sf comms emails update <email_uuid>",
      "description": "Change a flow or campaign email's subject or preview text; a flag left out keeps its value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--subject <text>",
          "description": "the new subject line, 5 to 150 characters"
        },
        {
          "flags": "--preview-text <text>",
          "description": "the new preview text, 5 to 150 characters"
        },
        {
          "flags": "--live",
          "description": "required when the email is live: acknowledge a change customers receive"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--resubmit",
          "description": "required when the email is rejected or pending_review: the edit takes it out of review, and the merchant resubmits it"
        },
        {
          "flags": "--dry-run",
          "description": "read the email, show what would change and what the change would need, and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails request-review",
      "usage": "sf comms emails request-review <email_uuid>",
      "description": "Ask for a content review of an email: the review runs in the background and the signed-in person gets the ruling; no test copy is sent",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--order <id>",
          "description": "for an email in an order-triggered flow: a test order id, latest-test or latest-test-digital (see 'sf orders test-orders')"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails render",
      "usage": "sf comms emails render <email_uuid>",
      "description": "Render a flow or campaign email, saved or a draft, as a test send would, and send nothing",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--draft <file>",
          "description": "an unsaved CJSON container to render in place of the saved one; nothing is saved"
        },
        {
          "flags": "--order <id>",
          "description": "a test order: an order id, latest-test, or latest-test-digital (see 'sf orders test-orders'); a real customer order is refused"
        },
        {
          "flags": "--cart-item <id>",
          "description": "an item id for the cart the email renders with (repeatable) (default: [])"
        },
        {
          "flags": "--out <dir>",
          "description": "write <name>.html and <name>.txt as new files in this existing directory"
        },
        {
          "flags": "--png",
          "description": "also write <name>-<width>.png into --out: the email as a mail client shows it, from a local Chrome"
        },
        {
          "flags": "--viewport <widths>",
          "description": "with --png, the width in pixels, or a comma list such as 600,375 (default 600)"
        },
        {
          "flags": "--chrome <path>",
          "description": "with --png, the Chrome executable, when Chrome is not installed in the usual place"
        },
        {
          "flags": "--customer-name <name>",
          "description": "the name the email greets; the greeting uses its first word (default: the signed-in user's name)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails clicks",
      "usage": "sf comms emails clicks <email_uuid>",
      "description": "The links clicked in one email of a campaign or flow, most clicked first (read only)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--sequence <uuid>",
          "description": "the communication_sequence_uuid of the campaign or flow that sends it"
        },
        {
          "flags": "--days <n>",
          "description": "how many days back, 1 to 365 (default 30)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms emails test",
      "usage": "sf comms emails test <email_uuid>",
      "description": "Send one test of a campaign or flow email to a user on the account; always --live (render it first: it sends nothing)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--sequence <uuid>",
          "description": "the communication_sequence_uuid of the campaign or flow that sends it"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the email step, from 'sf comms sequences get'"
        },
        {
          "flags": "--to <email>",
          "description": "the email address of a user on this UltraCart account"
        },
        {
          "flags": "--order <id>",
          "description": "a test order: an order id, latest-test, or latest-test-digital (see 'sf orders test-orders'); a real customer order is refused"
        },
        {
          "flags": "--cart-item <id>",
          "description": "a cart item id for the email's cart content; repeat for several (default: [])"
        },
        {
          "flags": "--live",
          "description": "required: it reaches a real inbox and counts against the plan's send limits"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms transactional",
      "usage": "sf comms transactional",
      "description": "Transactional emails, such as the order receipt (list, get, update, render)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms transactional get",
      "usage": "sf comms transactional get <file_name>",
      "description": "One transactional email's subject, delivery options and sender, with the storefronts that share the sender and the hash_sha256 for --if-match",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms transactional update",
      "usage": "sf comms transactional update <file_name>",
      "description": "Change a transactional email's subject, delivery options or sender; always --live, and approved by the signed-in person first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--subject <text>",
          "description": "a new subject, one line of 1 to 150 characters (translations aren't changed)"
        },
        {
          "flags": "--option <name=on|off>",
          "description": "turn one delivery option on or off, by its name from 'get'; repeat for several (default: [])"
        },
        {
          "flags": "--sending-domain <uuid>",
          "description": "send from this sending domain, from 'sf comms domains list'"
        },
        {
          "flags": "--sending-user <name>",
          "description": "the part of the from address before the @"
        },
        {
          "flags": "--sending-name <text>",
          "description": "the from name"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the email's hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required: the change reaches every matching order from the moment it's saved"
        },
        {
          "flags": "--dry-run",
          "description": "read the email, ask the server what would change, and write nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving, why the email should change (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms transactional list",
      "usage": "sf comms transactional list",
      "description": "The storefront's transactional emails: name, template file_name, text_file_name when the email has a text template, and body_file_name and body_path when its theme has a body container",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms transactional render",
      "usage": "sf comms transactional render <file_name>",
      "description": "Render a transactional email (a file_name from list, such as receipt_html.vm), saved or a draft, and send nothing",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--draft <file>",
          "description": "an unsaved CJSON container to render in place of the saved one; nothing is saved"
        },
        {
          "flags": "--order <id>",
          "description": "a test order: an order id, latest-test, or latest-test-digital (see 'sf orders test-orders'); a real customer order is refused"
        },
        {
          "flags": "--cart-item <id>",
          "description": "an item id for the cart the email renders with (repeatable) (default: [])"
        },
        {
          "flags": "--out <dir>",
          "description": "write <name>.html and <name>.txt as new files in this existing directory"
        },
        {
          "flags": "--png",
          "description": "also write <name>-<width>.png into --out: the email as a mail client shows it, from a local Chrome"
        },
        {
          "flags": "--viewport <widths>",
          "description": "with --png, the width in pixels, or a comma list such as 600,375 (default 600)"
        },
        {
          "flags": "--chrome <path>",
          "description": "with --png, the Chrome executable, when Chrome is not installed in the usual place"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms library",
      "usage": "sf comms library",
      "description": "The code library the admin's 'start from library' uses (not 'sf library', the Visual Builder element library): emails, add-email, get",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms library emails",
      "usage": "sf comms library emails",
      "description": "Code-library email items this storefront can start an email from, by title, with their subject, preview text and source (owned, shared or public)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "only items whose title contains this text (case-sensitive, up to 100 characters)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms library add-email",
      "usage": "sf comms library add-email",
      "description": "Save a reusable email design (body, subject, preview text) to the account's private code library, for the admin's new-email 'start from library' picker; no flow, campaign or send",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <cjson>",
          "description": "the email body: a CJSON container file, as 'sf containers pull --owner-type email' writes one"
        },
        {
          "flags": "--title <text>",
          "description": "the item's title in the picker, 4 to 100 characters"
        },
        {
          "flags": "--subject <text>",
          "description": "the subject an email started from it gets, 5 to 150 characters"
        },
        {
          "flags": "--preview-text <text>",
          "description": "the preview text an email started from it gets, 5 to 150 characters"
        },
        {
          "flags": "--description <text>",
          "description": "shown under the title in the picker, up to 1000 characters"
        },
        {
          "flags": "--uuid <uuid>",
          "description": "the uuid a previous save printed: saving it again returns that item instead of a second one"
        },
        {
          "flags": "--allow-duplicate-title",
          "description": "save even when an item the account owns already has this title"
        },
        {
          "flags": "--dry-run",
          "description": "check the body, the title and the files, show where it would go, and save nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms library get",
      "usage": "sf comms library get <library_item_oid>",
      "description": "One code-library email item: title, subject, preview text, source and files, with its body CJSON; --out writes the CJSON to a new file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "write the body CJSON to this new file instead of the JSON (an existing file is never replaced)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms postcards",
      "usage": "sf comms postcards",
      "description": "Flow and campaign postcards (tracking, pull, push, proof, mail-test)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms postcards tracking",
      "usage": "sf comms postcards tracking <postcard_uuid>",
      "description": "Every card mailed for a postcard, newest first: status, cost, dates and the order it converted to; recipients masked",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--page <n>",
          "description": "the page, from 1"
        },
        {
          "flags": "--page-size <n>",
          "description": "cards per page, 1 to 100 (default 50)"
        },
        {
          "flags": "--show-customer-data",
          "description": "return real names, email addresses and street addresses instead of masked ones. This puts them into this transcript: use it only when the merchant asks for a person's details, and never paste them into issues, chats or commits. Needs a profile with publish permission; the server logs every such read"
        },
        {
          "flags": "--audit-log <file>",
          "description": "append one JSON line per read to this file: what was read and how many rows, never a customer value"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms postcards pull",
      "usage": "sf comms postcards pull <dir>",
      "description": "Pull a postcard's front and back, with postcard.json, into an existing directory that holds no pull",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--postcard <postcard_uuid>",
          "description": "the postcard, from 'sf comms flows list' or 'sf comms campaigns list'"
        },
        {
          "flags": "--side <side>",
          "description": "front or back: pull one side only"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms postcards push",
      "usage": "sf comms postcards push <dir>",
      "description": "Push a pulled postcard: both sides checked first, then the front, then the back; the front is undone if the back is refused",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--side <side>",
          "description": "front or back: push one side only"
        },
        {
          "flags": "--live",
          "description": "acknowledge that the flow or campaign is live, so customers reaching the step are mailed the new card"
        },
        {
          "flags": "--comment <text>",
          "description": "history comment recorded with each side's write"
        },
        {
          "flags": "--allow-warnings",
          "description": "store a side even if validation returns warnings"
        },
        {
          "flags": "--dry-run",
          "description": "run every check and write nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms postcards proof",
      "usage": "sf comms postcards proof <sequence_uuid>",
      "description": "Proof a postcard step as it would print: both sides' HTML, and the print vendor's PNGs and proof PDF from a dry run; nothing is mailed",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the postcard step, from 'sf comms campaigns|flows list' or 'sf comms sequences get'"
        },
        {
          "flags": "--customer-name <name>",
          "description": "the name the card greets and is addressed to (default: the signed-in user's name)"
        },
        {
          "flags": "--address1 <text>",
          "description": "the recipient street address; with --city, --state and --postal-code (default: a sample address)"
        },
        {
          "flags": "--address2 <text>",
          "description": "the second address line"
        },
        {
          "flags": "--city <text>",
          "description": "the recipient city"
        },
        {
          "flags": "--state <text>",
          "description": "the recipient state"
        },
        {
          "flags": "--postal-code <text>",
          "description": "the recipient postal code"
        },
        {
          "flags": "--order <id>",
          "description": "a test order: an order id, latest-test, or latest-test-digital (see 'sf orders test-orders'); a real customer order is refused"
        },
        {
          "flags": "--cart-item <id>",
          "description": "an item id for the cart a cart flow's card renders with (repeatable) (default: [])"
        },
        {
          "flags": "--html-only",
          "description": "only render both sides' HTML; no print vendor dry run, PNGs or PDF"
        },
        {
          "flags": "--out <dir>",
          "description": "write the HTML, PNGs and PDF as new files in this existing directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms postcards mail-test",
      "usage": "sf comms postcards mail-test <sequence_uuid>",
      "description": "Print and mail one test postcard at the account's cost; --live, --mail-card and the signed-in person's approval (proof it first: it mails nothing)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--step <step_uuid>",
          "description": "the postcard step, from 'sf comms sequences get'"
        },
        {
          "flags": "--to-name <text>",
          "description": "the recipient's name"
        },
        {
          "flags": "--address1 <text>",
          "description": "the first street line"
        },
        {
          "flags": "--address2 <text>",
          "description": "the second street line"
        },
        {
          "flags": "--city <text>",
          "description": "the city"
        },
        {
          "flags": "--state <text>",
          "description": "the state"
        },
        {
          "flags": "--postal-code <text>",
          "description": "the postal code"
        },
        {
          "flags": "--order <id>",
          "description": "a test order: an order id, latest-test, or latest-test-digital (see 'sf orders test-orders'); a real customer order is refused"
        },
        {
          "flags": "--cart-item <id>",
          "description": "a cart item id for the card's content; repeat for several (default: [])"
        },
        {
          "flags": "--live",
          "description": "required: a real card is printed and mailed"
        },
        {
          "flags": "--mail-card",
          "description": "required as well as --live: the card costs money and can't be recalled"
        },
        {
          "flags": "--dry-run",
          "description": "show what the card would cost, and mail nothing (no approval needed)"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving, why a test card should be mailed (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms settings",
      "usage": "sf comms settings",
      "description": "The storefront's Communications settings: postcard return address, default marketing and transactional senders, and SMS number (get, set)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms settings get",
      "usage": "sf comms settings get",
      "description": "The postcard return address, default senders and SMS number, with notes on what each drives and the hash_sha256 for --if-match",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms settings set",
      "usage": "sf comms settings set",
      "description": "Change the postcard return address, a default sender or the SMS number; a sender or SMS number change needs --live and the signed-in person's approval",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--return-name <text>",
          "description": "the return address's name line; \"\" clears it"
        },
        {
          "flags": "--return-address1 <text>",
          "description": "its first street line; \"\" clears it"
        },
        {
          "flags": "--return-address2 <text>",
          "description": "its second street line; \"\" clears it"
        },
        {
          "flags": "--return-city <text>",
          "description": "its city; \"\" clears it"
        },
        {
          "flags": "--return-state <text>",
          "description": "its state; \"\" clears it"
        },
        {
          "flags": "--return-postal-code <text>",
          "description": "its postal code; \"\" clears it"
        },
        {
          "flags": "--marketing-domain <uuid>",
          "description": "the default marketing sender's sending domain, from 'sf comms domains list'"
        },
        {
          "flags": "--marketing-user <name>",
          "description": "the default marketing from address, the part before the @"
        },
        {
          "flags": "--marketing-name <text>",
          "description": "the default marketing from name"
        },
        {
          "flags": "--transactional-domain <uuid>",
          "description": "the transactional sender's sending domain, from 'sf comms domains list'"
        },
        {
          "flags": "--transactional-user <name>",
          "description": "the transactional from address, the part before the @"
        },
        {
          "flags": "--transactional-name <text>",
          "description": "the transactional from name"
        },
        {
          "flags": "--sms-number <e164>",
          "description": "the default SMS number for new flows and campaigns, such as +14045550100, on the account's Twilio account; \"\" clears it"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the settings' hash_sha256 you read, instead of the one read now"
        },
        {
          "flags": "--live",
          "description": "required for a sender or SMS number change: it applies from the moment it's saved"
        },
        {
          "flags": "--dry-run",
          "description": "read the settings, ask the server what would change, and write nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving, why the sender or number should change (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms plan",
      "usage": "sf comms plan",
      "description": "The account's Communications plan: limits, what was sent against them, and whether sending is paused (read only)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms templates",
      "usage": "sf comms templates",
      "description": "The email templates a new email can start from (list, get)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms templates list",
      "usage": "sf comms templates list",
      "description": "Every template a new email can start from: source, email_template_oid, path, name, description and trigger_type",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms templates get",
      "usage": "sf comms templates get <email_template_oid>",
      "description": "One of the account's templates with its container CJSON; --out writes the CJSON to a new file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "write container_cjson to this new file instead of the JSON (an existing file is never replaced)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms providers",
      "usage": "sf comms providers",
      "description": "Outside email providers and their lists, and importing those lists (list, import)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms providers list",
      "usage": "sf comms providers list",
      "description": "Each provider, whether it's connected, its lists with their ids, and whether the account may import",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms providers import",
      "usage": "sf comms providers import",
      "description": "Import a provider's lists as new lists, subscribing every member in the background; --live and the signed-in person's approval",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--provider <name>",
          "description": "the provider's name from 'sf comms providers list'"
        },
        {
          "flags": "--list <id>",
          "description": "a list id from 'sf comms providers list'; repeat for several, up to 20 (default: [])"
        },
        {
          "flags": "--live",
          "description": "required: every member is subscribed, and it can't be undone from here"
        },
        {
          "flags": "--dry-run",
          "description": "ask the server what would be imported, and import nothing"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving, why these lists should be imported (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms stats",
      "usage": "sf comms stats",
      "description": "Communications statistics across flows and campaigns (dashboard)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms stats dashboard",
      "usage": "sf comms stats dashboard",
      "description": "Each flow's and campaign's statistics over --days, and the last 31 days' daily totals (read only)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--days <n>",
          "description": "how many days back the per-row counts cover, 1 to 365 (default 30)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms ruler",
      "usage": "sf comms ruler",
      "description": "Event Ruler patterns for Is in BigQuery segment rules (validate)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms ruler validate",
      "usage": "sf comms ruler validate <file>",
      "description": "Check that the Event Ruler pattern in a file compiles, before it goes into an Is in BigQuery segment rule",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms unreferenced",
      "usage": "sf comms unreferenced",
      "description": "The storefront's emails and postcards that no step names, so nothing sends them (read only)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf comms lookup",
      "usage": "sf comms lookup <uuid>",
      "description": "Which storefront a campaign, flow, sequence, step, email, postcard, list or segment uuid is on, its owner, and the command that reads it (read only)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/communications"
    },
    {
      "path": "sf events",
      "usage": "sf events",
      "description": "Watch for changes this sign-in waits on (approvals decided), instead of polling",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf events watch",
      "usage": "sf events watch",
      "description": "Print one JSON event per line as they happen; status lines go to stderr",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "only events about this storefront, plus merchant-level ones (repeatable) (default: [])"
        },
        {
          "flags": "--type <type>",
          "description": "print only events of this type, such as approval.decided (repeatable) (default: [])"
        },
        {
          "flags": "--since <event_id>",
          "description": "replay events after this event id first"
        },
        {
          "flags": "--cursor-file <path>",
          "description": "read the starting event id from this file, and save the last one seen to it"
        },
        {
          "flags": "--until <type[:object_id]>",
          "description": "exit 0 at the first matching event, such as approval.decided:ap_123"
        },
        {
          "flags": "--timeout <seconds>",
          "description": "exit 3 if nothing matched --until in this many seconds"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/safety-and-approvals"
    },
    {
      "path": "sf library",
      "usage": "sf library",
      "description": "Find, save, share and install reusable fragments (one widget and its children) in the element library",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library taxonomy",
      "usage": "sf library taxonomy",
      "description": "The fixed tag list: purpose, section, industry and style, each tag with what it is for",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--check",
          "description": "compare the server's list with the copy this CLI and its skill ship"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library search",
      "usage": "sf library search [query]",
      "description": "Search the library by name, description and tags; results leave out the fragment itself",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--segment <segment>",
          "description": "mine (default), bookmarked, shared (with you), featured or public"
        },
        {
          "flags": "--page <n>",
          "description": "page number, starting at 1"
        },
        {
          "flags": "--per-page <n>",
          "description": "results per page, 1 to 200 (default 50)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library get",
      "usage": "sf library get <oid>",
      "description": "Read one entry: its scan first, then its fragment, tags and parameters",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--revision <n>",
          "description": "a published revision"
        },
        {
          "flags": "--out <file>",
          "description": "also write the fragment's cjson to this new file"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library history",
      "usage": "sf library history <oid>",
      "description": "The entry's published revisions, newest first, with their release notes",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library add",
      "usage": "sf library add",
      "description": "Save a widget and its children from a local CJSON file as a new private library entry",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--from-widget <file-and-selector...>",
          "description": "the local CJSON file and the widget to save, such as page.cjson #hero-123"
        },
        {
          "flags": "--name <name>",
          "description": "the entry's name, up to 100 characters"
        },
        {
          "flags": "--description <text>",
          "description": "what it is and when to use it, up to 1024 characters"
        },
        {
          "flags": "--purpose <slug>",
          "description": "purpose tag; repeat for several (at least one on add)"
        },
        {
          "flags": "--section <slug>",
          "description": "section tag; repeat for several"
        },
        {
          "flags": "--industry <slug>",
          "description": "industry tag; repeat for several"
        },
        {
          "flags": "--style <slug>",
          "description": "style tag; repeat for several"
        },
        {
          "flags": "--param <spec>",
          "description": "a parameter as name:type[:required][=default]; repeat for several. Types: string, number, boolean, url, color, image, item-id, item-oid"
        },
        {
          "flags": "--share-with-account",
          "description": "let every user on this account see published revisions"
        },
        {
          "flags": "--screenshot <png>",
          "description": "a PNG of the widget, from 'sf library capture'"
        },
        {
          "flags": "--screenshot-source <source>",
          "description": "where the screenshot came from: own, licensed or stock"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library update",
      "usage": "sf library update <oid>",
      "description": "Change your draft: only what the flags name changes; nothing others see changes until you publish",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--from-widget <file-and-selector...>",
          "description": "replace the fragment with this widget from a local CJSON file, such as page.cjson #hero-123"
        },
        {
          "flags": "--name <name>",
          "description": "the entry's name, up to 100 characters"
        },
        {
          "flags": "--description <text>",
          "description": "what it is and when to use it, up to 1024 characters"
        },
        {
          "flags": "--purpose <slug>",
          "description": "purpose tag; repeat for several (at least one on add)"
        },
        {
          "flags": "--section <slug>",
          "description": "section tag; repeat for several"
        },
        {
          "flags": "--industry <slug>",
          "description": "industry tag; repeat for several"
        },
        {
          "flags": "--style <slug>",
          "description": "style tag; repeat for several"
        },
        {
          "flags": "--param <spec>",
          "description": "a parameter as name:type[:required][=default]; repeat for several. Types: string, number, boolean, url, color, image, item-id, item-oid"
        },
        {
          "flags": "--share-with-account",
          "description": "let every user on this account see published revisions"
        },
        {
          "flags": "--no-share-with-account",
          "description": "stop every user on this account seeing published revisions"
        },
        {
          "flags": "--clear-params",
          "description": "remove every parameter"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you reviewed, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library capture",
      "usage": "sf library capture",
      "description": "Screenshot one widget as a signed-out shopper sees it, in a local headless Chrome, to a new PNG",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme to show, which may be inactive"
        },
        {
          "flags": "--widget <id>",
          "description": "the widget to capture, such as hero-123"
        },
        {
          "flags": "--out <png>",
          "description": "the new PNG file to write"
        },
        {
          "flags": "--path <path>",
          "description": "storefront page the widget is on (default: \"/\")"
        },
        {
          "flags": "--viewport <widths>",
          "description": "browser width in pixels, or a comma list such as 1440,390 (default 1440)"
        },
        {
          "flags": "--session <id>",
          "description": "preview session from 'sf preview start', to capture staged content"
        },
        {
          "flags": "--chrome <path>",
          "description": "Chrome executable, when Chrome is not installed in the usual place"
        },
        {
          "flags": "--keep-overlays",
          "description": "leave fixed and sticky elements outside the widget showing"
        },
        {
          "flags": "--wait-for <selector>",
          "description": "a CSS selector inside the widget to wait for, such as '.price'"
        },
        {
          "flags": "--hover <selector>",
          "description": "a CSS selector for one element inside the widget to hover before the shot"
        },
        {
          "flags": "--open <id>",
          "description": "a tab, slide, sidepanel or modal to open first, such as tab-12"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library screenshot",
      "usage": "sf library screenshot <oid>",
      "description": "Set your entry's screenshot from a PNG, or clear it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <png>",
          "description": "the PNG to set, from 'sf library capture'"
        },
        {
          "flags": "--source <source>",
          "description": "where it came from: own, licensed or stock"
        },
        {
          "flags": "--clear",
          "description": "remove the screenshot and thumbnail"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you reviewed, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library publish",
      "usage": "sf library publish <oid>",
      "description": "Freeze your draft as a published revision your linked accounts can see, or with --public every merchant",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--release-notes <text>",
          "description": "what changed in this revision"
        },
        {
          "flags": "--public",
          "description": "publish to every merchant (staff-enabled accounts only)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you reviewed, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library unpublish",
      "usage": "sf library unpublish <oid>",
      "description": "Narrow who sees your published revisions; history and existing installs are kept",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--to <visibility>",
          "description": "shared or private"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library share-targets",
      "usage": "sf library share-targets",
      "description": "Your linked accounts: the only merchants an entry can be shared with",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library share",
      "usage": "sf library share <oid>",
      "description": "Share your published entry with one linked account",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--with-merchant <id>",
          "description": "the linked account's merchant id, from 'sf library share-targets'"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library unshare",
      "usage": "sf library unshare <oid>",
      "description": "Stop one linked account installing your entry; its existing installs keep their copies",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--with-merchant <id>",
          "description": "the linked account's merchant id"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library install",
      "usage": "sf library install <oid>",
      "description": "Copy an entry's files into this storefront and hand back its fragment to place; never places it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge writing files shoppers are served from"
        },
        {
          "flags": "--revision <n>",
          "description": "a published revision instead of the latest"
        },
        {
          "flags": "--on-conflict <mode>",
          "description": "fail, skip or overwrite"
        },
        {
          "flags": "--allow-executable",
          "description": "install an entry whose scan lists executable content, having read it"
        },
        {
          "flags": "--as-recipe <file>",
          "description": "write the fragment as a new local recipe file, for 'recipe instantiate'"
        },
        {
          "flags": "--out <file>",
          "description": "write the fragment's cjson to a new file"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library installs",
      "usage": "sf library installs",
      "description": "The entries installed on this storefront, with the revision installed and the latest",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--outdated",
          "description": "only entries with a newer published revision"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library duplicate",
      "usage": "sf library duplicate <oid>",
      "description": "Copy an entry you can see into a new private draft you own",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the copy's name (default: Copy of …)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library delete",
      "usage": "sf library delete <oid>",
      "description": "Delete your entry, or retire it when it was published, shared or installed",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you reviewed, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf library favorite",
      "usage": "sf library favorite <oid>",
      "description": "Bookmark an entry for yourself, or remove the bookmark; 'search --segment bookmarked' lists them",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--remove",
          "description": "remove the bookmark"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/library-and-reusable-content"
    },
    {
      "path": "sf i18n",
      "usage": "sf i18n",
      "description": "A storefront's languages, its built-in messages, where translations come from, and its glossary",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n languages",
      "usage": "sf i18n languages",
      "description": "The storefront's languages, their codes and aliases, and the cost of enabling one more; saves the code table for 'cjson translate'",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n languages list",
      "usage": "sf i18n languages list",
      "description": "List the languages (the default when no subcommand is given)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n languages enable",
      "usage": "sf i18n languages enable <code>",
      "description": "Turn a language on: it is served and machine translated, which is billed",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change shoppers see"
        },
        {
          "flags": "--acknowledge-cost",
          "description": "required: the merchant has agreed to the machine translation cost"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n languages disable",
      "usage": "sf i18n languages disable <code>",
      "description": "Stop serving a language; its translations are kept for when it comes back",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change shoppers see"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n messages",
      "usage": "sf i18n messages",
      "description": "Search the built-in messages: the system text templates render by key, such as checkout labels",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n messages list",
      "usage": "sf i18n messages list",
      "description": "Search the messages (the default when no subcommand is given)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "match the key or the English text"
        },
        {
          "flags": "--language <code>",
          "description": "show only this language's translations"
        },
        {
          "flags": "--overridden",
          "description": "only messages with edited English or a hand translation"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid (default: the active theme)"
        },
        {
          "flags": "--offset <n>",
          "description": "skip this many messages"
        },
        {
          "flags": "--limit <n>",
          "description": "messages per page, 1 to 500 (default 200)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n messages get",
      "usage": "sf i18n messages get <key>",
      "description": "Read one message, with the hash a set or reset sends back",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid (default: the active theme)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n messages set",
      "usage": "sf i18n messages set <key>",
      "description": "Change one message in any number of its languages; languages not named are left alone",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--text <code=text>",
          "description": "a language and its text, such as ESP=Seguir; repeat for several (default: [])"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid (default: the active theme)"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change shoppers see"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n messages reset",
      "usage": "sf i18n messages reset <key>",
      "description": "Put a message back to the template's text; every language falls back to machine translation",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid (default: the active theme)"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change shoppers see"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n machine",
      "usage": "sf i18n machine [file] [selector] [property]",
      "description": "Where each language's text comes from for one widget setting or message: hand, machine, pending or none",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--message <key>",
          "description": "a built-in message instead of a widget setting"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid (default: the active theme)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n glossary",
      "usage": "sf i18n glossary",
      "description": "Read the storefront's translation glossary: terms not to translate, required translations, tone, words to avoid",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n glossary get",
      "usage": "sf i18n glossary get",
      "description": "Read the glossary (the default when no subcommand is given)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "also write the markdown to this new file"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n glossary put",
      "usage": "sf i18n glossary put <file>",
      "description": "Replace the storefront's glossary with a markdown file, up to 64 KB",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change every agent on this storefront follows"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf i18n glossary init",
      "usage": "sf i18n glossary init <file>",
      "description": "Write the starter glossary template to a new local file; sends nothing",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/languages"
    },
    {
      "path": "sf redirects",
      "usage": "sf redirects",
      "description": "The storefront's redirect rules: real 301 redirects for moved or removed URLs",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects list",
      "usage": "sf redirects list",
      "description": "List the rules (the default when no subcommand is given), with the count and the limit",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "match the source, target or note"
        },
        {
          "flags": "--type <type>",
          "description": "exact or pattern"
        },
        {
          "flags": "--status <status>",
          "description": "301, 302 or rewrite"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects get",
      "usage": "sf redirects get <id>",
      "description": "Read one rule, with the hash an update or delete sends back",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects resolve",
      "usage": "sf redirects resolve [path]",
      "description": "What a shopper gets for a path, or for every path in a file: each redirect followed, the final path and status, and what it lands on",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <paths>",
          "description": "resolve every path in this file instead of one"
        },
        {
          "flags": "--out <csv>",
          "description": "with --file: write the 404 paths as an import CSV to fill in"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects export",
      "usage": "sf redirects export <file>",
      "description": "Write every rule to a CSV: the import format (the default), or the admin's own four columns with --admin",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--admin",
          "description": "write the admin's four-column mapping file instead of the import format"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects add",
      "usage": "sf redirects add <source> <target>",
      "description": "Create one 301 redirect, live at once; --dry-run checks it without writing",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--note <text>",
          "description": "why the rule exists (up to 500 characters)"
        },
        {
          "flags": "--over-live-page",
          "description": "allow a source that is a live page or item, which the rule then hides"
        },
        {
          "flags": "--include-in-sitemap",
          "description": "keep the rule's source in the generated sitemap (left out by default)"
        },
        {
          "flags": "--dry-run",
          "description": "check the rule and print the findings, exiting 1 when it would be refused; writes nothing and needs no --live"
        },
        {
          "flags": "--live",
          "description": "required to write: acknowledge a change shoppers see"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects update",
      "usage": "sf redirects update <id>",
      "description": "Change one rule's source, target, note or sitemap listing, or make an admin rule a 301; flags left out keep their value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--source <path>",
          "description": "the new source"
        },
        {
          "flags": "--target <path>",
          "description": "the new target (unpins the rule from a page)"
        },
        {
          "flags": "--note <text>",
          "description": "the new note"
        },
        {
          "flags": "--status <status>",
          "description": "301 only: turns an admin rule into a permanent redirect"
        },
        {
          "flags": "--over-live-page",
          "description": "allow a source that is a live page or item"
        },
        {
          "flags": "--exclude-from-sitemap",
          "description": "leave the rule's source out of the generated sitemap"
        },
        {
          "flags": "--include-in-sitemap",
          "description": "list the rule's source in the generated sitemap"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change shoppers see"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects delete",
      "usage": "sf redirects delete [id]",
      "description": "Delete one rule, or many with --ids: a dry run first, then --apply --live deletes what it checked",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change shoppers see"
        },
        {
          "flags": "--if-match <hash>",
          "description": "one rule: the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--ids <file>",
          "description": "many rules: a CSV or JSON file of redirect ids"
        },
        {
          "flags": "--apply",
          "description": "with --ids: delete the rules the last dry run checked"
        },
        {
          "flags": "--reason <text>",
          "description": "with --ids: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "with --ids: finish the next batch with an approval from an earlier run"
        },
        {
          "flags": "--wait <seconds>",
          "description": "with --ids: how long to wait for each decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects restore",
      "usage": "sf redirects restore <backup>",
      "description": "Put rules back from a 'sf redirects delete --ids' backup: a dry run first, then --apply --live",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--apply",
          "description": "write the rules the last dry run checked"
        },
        {
          "flags": "--live",
          "description": "required with --apply: acknowledge a change shoppers see"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf redirects import",
      "usage": "sf redirects import <csv>",
      "description": "Migrate rules from a CSV: a dry run first, then --apply --live writes exactly what it checked",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--admin",
          "description": "read the admin's four-column mapping file saved as CSV, instead of the import format"
        },
        {
          "flags": "--include-in-sitemap",
          "description": "keep imported rules in the generated sitemap where the file doesn't say"
        },
        {
          "flags": "--apply",
          "description": "write the rows the last dry run checked"
        },
        {
          "flags": "--live",
          "description": "required with --apply: acknowledge a change shoppers see"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found",
      "usage": "sf not-found",
      "description": "The paths shoppers asked for that answered 404, and the storefront's 404 page",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found list",
      "usage": "sf not-found list",
      "description": "List the top missed paths (the default when no subcommand is given)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--since <iso>",
          "description": "only paths seen since this ISO 8601 date or time"
        },
        {
          "flags": "--sort <order>",
          "description": "hits (default) or last-seen"
        },
        {
          "flags": "--include-bots",
          "description": "keep paths whose hits were all bots"
        },
        {
          "flags": "--include-tokens",
          "description": "show token-like path segments instead of {token}"
        },
        {
          "flags": "--search <text>",
          "description": "match the path"
        },
        {
          "flags": "--limit <n>",
          "description": "entries, 1 to 100 (default 50)"
        },
        {
          "flags": "--unfixed",
          "description": "only paths no redirect rule catches yet (what is left to fix)"
        },
        {
          "flags": "--fixed",
          "description": "only paths a redirect rule now catches"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found show",
      "usage": "sf not-found show <id>",
      "description": "One missed path with its recent hits: time, linking host, user agent and bot flag",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--include-tokens",
          "description": "show token-like path segments instead of {token}"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found ignore",
      "usage": "sf not-found ignore <id>",
      "description": "Hide a missed path from the list and stop counting it, such as scanner noise; --undo brings it back",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--undo",
          "description": "stop ignoring the path"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge the write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found fixed",
      "usage": "sf not-found fixed <id>",
      "description": "Mark a missed path fixed, for one fixed by creating the page rather than a redirect; the next hit lists it again",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge the write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found remove",
      "usage": "sf not-found remove <id>",
      "description": "Remove a missed path from the log; the next hit on it records it again",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge the write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found export",
      "usage": "sf not-found export <file>",
      "description": "Write up to 5,000 open missed paths, most hits first, as a redirect import CSV with the target blank to fill in",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--include-bots",
          "description": "keep paths whose hits were all bots"
        },
        {
          "flags": "--include-tokens",
          "description": "show token-like path segments instead of {token}"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found summary",
      "usage": "sf not-found summary",
      "description": "The 404 trend the admin charts: hits per day for 30 and 7 days and per hour for 24 hours, plus the busiest new paths",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf not-found page",
      "usage": "sf not-found page",
      "description": "The site_404.vm the active theme renders for a 404, whether it exists, and its status",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/redirects-and-404s"
    },
    {
      "path": "sf tracking",
      "usage": "sf tracking",
      "description": "Privacy rules, conversion settings and what is reported to analytics, ad and affiliate platforms",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking get",
      "usage": "sf tracking get",
      "description": "Read the privacy rules and advanced conversion settings, every key listed (unset ones as null), with each section's hash",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--section <section>",
          "description": "privacy or advanced; both when left out"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking privacy",
      "usage": "sf tracking privacy",
      "description": "The storefront's per-region privacy rules",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking privacy set",
      "usage": "sf tracking privacy set",
      "description": "Change one or more privacy rules; rules left out keep their value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--rule <key=region>",
          "description": "a rule and its region (all, eea, non-us or off); repeat for several (default: [])"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the privacy hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--dry-run",
          "description": "show each change without writing; needs no --live"
        },
        {
          "flags": "--live",
          "description": "required to write: acknowledge a change every shopper gets at once"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking advanced",
      "usage": "sf tracking advanced",
      "description": "The storefront's advanced conversion settings: URLs after checkout, the default currency and two switches",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking advanced set",
      "usage": "sf tracking advanced set",
      "description": "Change one or more advanced settings; settings left out keep their value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--set <key=value>",
          "description": "a setting and its new value; repeat for several (default: [])"
        },
        {
          "flags": "--unset <key>",
          "description": "clear a URL or the default currency; repeat for several (default: [])"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the advanced hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--dry-run",
          "description": "show each change without writing; needs no --live"
        },
        {
          "flags": "--live",
          "description": "required to write: acknowledge a change every shopper gets at once"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes",
      "usage": "sf tracking utm-shortcodes",
      "description": "Short codes that stand for a set of UTM and ITM values, for links in emails, ads and other sites",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes list",
      "usage": "sf tracking utm-shortcodes list",
      "description": "List the shortcodes (the default when no subcommand is given), with the count and the limit",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--search <text>",
          "description": "match the code, the description or a value"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes get",
      "usage": "sf tracking utm-shortcodes get <code>",
      "description": "Read one shortcode, with its two link forms and the hash an update or delete sends back",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes create",
      "usage": "sf tracking utm-shortcodes create <code>",
      "description": "Make a shortcode: 1 to 50 letters, digits, underscores and hyphens, with at least one UTM or ITM value",
      "options": [
        {
          "flags": "--description <text>",
          "description": "what the shortcode is for (up to 250 characters)"
        },
        {
          "flags": "--utm <part=value>",
          "description": "a UTM value: source, medium, campaign, term, content or id; repeat for several (default: [])"
        },
        {
          "flags": "--itm <part=value>",
          "description": "an ITM (internal) value, with the same parts; repeat for several (default: [])"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes update",
      "usage": "sf tracking utm-shortcodes update <code>",
      "description": "Change a shortcode's values, description or code; what you leave out keeps its value",
      "options": [
        {
          "flags": "--description <text>",
          "description": "what the shortcode is for (up to 250 characters)"
        },
        {
          "flags": "--utm <part=value>",
          "description": "a UTM value: source, medium, campaign, term, content or id; repeat for several (default: [])"
        },
        {
          "flags": "--itm <part=value>",
          "description": "an ITM (internal) value, with the same parts; repeat for several (default: [])"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--unset <field>",
          "description": "clear utm.<part>, itm.<part> or description; repeat for several (default: [])"
        },
        {
          "flags": "--rename <code>",
          "description": "give the shortcode a new code (links using the old one stop applying it)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change to links that may already be in use"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes delete",
      "usage": "sf tracking utm-shortcodes delete <code>",
      "description": "Delete a shortcode; links already using it stop applying its values",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge a change to links that may already be in use"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking utm-shortcodes url",
      "usage": "sf tracking utm-shortcodes url <code>",
      "description": "Print a shortcode's storefront link and, with --external, its link for another site; reads only",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "the storefront path to append the code to (default /)"
        },
        {
          "flags": "--external <url>",
          "description": "an https:// page running UC Analytics, to add the usc parameter to"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking smart-attribution",
      "usage": "sf tracking smart-attribution",
      "description": "How conversions are shared between ad and affiliate platforms, and, when active, what each is sent",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking smart-attribution get",
      "usage": "sf tracking smart-attribution get",
      "description": "Read the configuration (the default): mode, model, split, lookback, platforms and those detected but not configured",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking smart-attribution enable",
      "usage": "sf tracking smart-attribution enable",
      "description": "Turn Smart Attribution on in report_only mode, which changes nothing any platform is sent",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "required: acknowledge the change"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking smart-attribution set",
      "usage": "sf tracking smart-attribution set",
      "description": "Change the mode, model, split, lookback or platforms; what you leave out keeps its value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--mode <mode>",
          "description": "disabled, report_only or active"
        },
        {
          "flags": "--model <model>",
          "description": "position-based, linear, time-decay or custom"
        },
        {
          "flags": "--split <o,a,c>",
          "description": "the originator, assist and closer shares, totalling 1, such as 0.4,0.2,0.4"
        },
        {
          "flags": "--lookback <days>",
          "description": "how far back touches count, 7 to 365 days"
        },
        {
          "flags": "--platforms <file>",
          "description": "a JSON array of platforms, as 'get' prints them; replaces the whole list"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--dry-run",
          "description": "show the change over what is stored and whether it needs an approval, without writing"
        },
        {
          "flags": "--live",
          "description": "required to write"
        },
        {
          "flags": "--reason <text>",
          "description": "when an approval is needed: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run of this exact change"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking smart-attribution delete",
      "usage": "sf tracking smart-attribution delete",
      "description": "Delete the configuration: every platform goes back to being sent conversions as before",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "required"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking providers",
      "usage": "sf tracking providers",
      "description": "The tracking providers the server knows, with their fields, events, consent gate and OAuth state",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--configured",
          "description": "only the providers with something set"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking integration",
      "usage": "sf tracking integration",
      "description": "Read, change or clear one tracking provider",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking integration get",
      "usage": "sf tracking integration get <provider>",
      "description": "One provider: values (secrets as set and a mask only), events, consent gate, OAuth state, cost and the hash",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking integration set",
      "usage": "sf tracking integration set <provider>",
      "description": "Change a provider's fields, secrets, events, consent gate or wholesale account numbers; the rest keeps its value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--set <key=value>",
          "description": "a field and its value; repeat for several (default: [])"
        },
        {
          "flags": "--unset <key>",
          "description": "clear a field; repeat for several (default: [])"
        },
        {
          "flags": "--secret <key=handle|@request>",
          "description": "a secret field, from a secret handle or @request; repeat for several (default: [])"
        },
        {
          "flags": "--clear-secret <key>",
          "description": "clear a secret field; repeat for several (default: [])"
        },
        {
          "flags": "--event <Name[=on|off]>",
          "description": "turn a standard event on or off; repeat for several (default: [])"
        },
        {
          "flags": "--consent <Type:region|off>",
          "description": "the consent gate: Statistics, Preferences or Marketing, for all, eea or non-us shoppers; off removes it"
        },
        {
          "flags": "--wholesale <tier_oid=account>",
          "description": "a wholesale pricing tier's GA account number; repeat for several (default: [])"
        },
        {
          "flags": "--accept-cost",
          "description": "agree to a billed option's price (Google Tag Gateway), after the merchant has agreed"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--dry-run",
          "description": "show the changes without writing (no secrets are requested)"
        },
        {
          "flags": "--live",
          "description": "required to write: every shopper's page changes at once"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person, for @request and an approval (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run of this exact change"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking integration clear",
      "usage": "sf tracking integration clear <provider>",
      "description": "Clear every field, secret, event and the consent gate the API can change, and turn off Google Tag Gateway",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "required: the provider stops being sent anything at once"
        },
        {
          "flags": "--dry-run",
          "description": "show what the clear would change, and whether it needs an approval, without writing; needs no --live"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run of this exact clear"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking html",
      "usage": "sf tracking html",
      "description": "The custom tracking HTML (every page but the receipt) and conversion HTML (the receipt)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking html list",
      "usage": "sf tracking html list",
      "description": "Both slots' sizes and hashes, without the HTML (the default)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking html pull",
      "usage": "sf tracking html pull <file>",
      "description": "Write a slot's HTML to a new local file, with a .sf.json baseline beside it",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--slot <slot>",
          "description": "tracking or conversion"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking html diff",
      "usage": "sf tracking html diff <file>",
      "description": "Compare a local file with the slot now, and with its pull baseline; reads only",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--slot <slot>",
          "description": "tracking or conversion"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking html render",
      "usage": "sf tracking html render",
      "description": "Render the conversion HTML, or a local draft of it, as a test order's receipt would; reads only",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--order <id>",
          "description": "a test order id from 'sf orders test-orders', or latest-test"
        },
        {
          "flags": "--slot <slot>",
          "description": "conversion, the only slot that renders (default: \"conversion\")"
        },
        {
          "flags": "--file <draft>",
          "description": "render this local file instead of the stored slot"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking html push",
      "usage": "sf tracking html push <file>",
      "description": "Write a local file to a slot, sending its baseline's hash; HTML needs UltraCart's review and the person's approval",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--slot <slot>",
          "description": "tracking or conversion"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the slot's hash_sha256, for a file with no pull baseline"
        },
        {
          "flags": "--dry-run",
          "description": "check the content and say whether it needs an approval, without writing"
        },
        {
          "flags": "--live",
          "description": "required to write: every shopper gets it at once"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run of this exact push"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking affiliate-networks",
      "usage": "sf tracking affiliate-networks",
      "description": "Affiliate networks: how a visit from each is detected and the conversion pixel it is sent",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking affiliate-networks list",
      "usage": "sf tracking affiliate-networks list",
      "description": "List the networks (the default), without their pixels",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking affiliate-networks get",
      "usage": "sf tracking affiliate-networks get <oid>",
      "description": "Read one network, with its pixel and the hash an update or delete sends back",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking affiliate-networks create",
      "usage": "sf tracking affiliate-networks create",
      "description": "Add a network: network_name, parameter_name and parameter_value are required",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <json>",
          "description": "a JSON object of the fields to set"
        },
        {
          "flags": "--pixel <file>",
          "description": "a file holding the conversion pixel: HTML for custom, one https URL for server_to_server"
        },
        {
          "flags": "--dry-run",
          "description": "check the change and say whether it needs an approval, without writing"
        },
        {
          "flags": "--live",
          "description": "required to write: the receipt changes for every order at once"
        },
        {
          "flags": "--reason <text>",
          "description": "when an approval is needed: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run of this exact change"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking affiliate-networks update",
      "usage": "sf tracking affiliate-networks update <oid>",
      "description": "Change a network's fields or pixel; what you leave out keeps its value",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file <json>",
          "description": "a JSON object of the fields to set"
        },
        {
          "flags": "--pixel <file>",
          "description": "a file holding the conversion pixel: HTML for custom, one https URL for server_to_server"
        },
        {
          "flags": "--dry-run",
          "description": "check the change and say whether it needs an approval, without writing"
        },
        {
          "flags": "--live",
          "description": "required to write: the receipt changes for every order at once"
        },
        {
          "flags": "--reason <text>",
          "description": "when an approval is needed: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run of this exact change"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking affiliate-networks delete",
      "usage": "sf tracking affiliate-networks delete <oid>",
      "description": "Delete a network; always needs the person's approval",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "the hash_sha256 you read, instead of reading it now"
        },
        {
          "flags": "--live",
          "description": "required"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "an approval from an earlier run"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the person's decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf tracking check",
      "usage": "sf tracking check",
      "description": "Plan a browser check of a page's tracking (--path), then grade what the browser collected (--results)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <page>",
          "description": "plan: the page to check, such as / or /checkout/receipt.html"
        },
        {
          "flags": "--event <event>",
          "description": "plan: page_view (the default) or purchase"
        },
        {
          "flags": "--order <id>",
          "description": "plan, with --event purchase: a test order id from 'sf orders test-orders', or latest-test"
        },
        {
          "flags": "--consent <state>",
          "description": "plan: none, all, or a comma list of statistics, preferences and marketing"
        },
        {
          "flags": "--region <region>",
          "description": "plan: eea, non-us or other, where the browser's IP address places it"
        },
        {
          "flags": "--snippet-out <file>",
          "description": "plan: write the in-page snippet to this new file instead of the JSON"
        },
        {
          "flags": "--results <file>",
          "description": "grade: the JSON the plan's snippet returned"
        },
        {
          "flags": "--strict",
          "description": "grade: warnings fail too"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf orders",
      "usage": "sf orders",
      "description": "Find test orders to render the order pages with; real customer orders are never listed",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/checkout-and-my-account"
    },
    {
      "path": "sf orders test-orders",
      "usage": "sf orders test-orders",
      "description": "List the account's test orders, newest first, from the whole order history (a just-placed order can take a moment to appear)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--limit <n>",
          "description": "most orders to return, 1 to 25 (default 10)"
        },
        {
          "flags": "--digital-items",
          "description": "only orders with digital downloads, for the download page"
        },
        {
          "flags": "--auto-order",
          "description": "only orders that started an auto order, for the subscription pages"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/checkout-and-my-account"
    },
    {
      "path": "sf logs",
      "usage": "sf logs",
      "description": "Read the storefront's server render logs, the ones the Developer Tools panel shows",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf logs list",
      "usage": "sf logs list",
      "description": "List recent render logs, newest first, with error and warning counts but no log text",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--uri <text>",
          "description": "only renders whose address contains this text, case insensitive"
        },
        {
          "flags": "--since <window>",
          "description": "how far back: 15m, 2h, 1d or an ISO-8601 time (default 1h, at most 7 days)"
        },
        {
          "flags": "--errors-only",
          "description": "only renders that logged an error or failed"
        },
        {
          "flags": "--limit <n>",
          "description": "most logs to return, 1 to 100 (default 25)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf logs get",
      "usage": "sf logs get <log_id>",
      "description": "Read one render's log lines at or above a level",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--level <level>",
          "description": "lowest level to show: debug, info, warn or error (default: \"warn\")"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf recordings",
      "usage": "sf recordings",
      "description": "Check or switch screen recording, read a visitor's recording and replay chosen page views on this machine",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf recordings show",
      "usage": "sf recordings show <screen_recording_uuid>",
      "description": "Show a recorded session and its page views, with named events such as rage clicks and script errors",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf recordings render",
      "usage": "sf recordings render <screen_recording_uuid>",
      "description": "Fetch chosen page views' replay events and render a timeline, frames and optionally video locally",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--page-view <uuid>",
          "description": "a page view to render (repeat for several); default every page view (default: [])"
        },
        {
          "flags": "--limit <n>",
          "description": "most page views one render may fetch, 1 to 25 (default 5)"
        },
        {
          "flags": "--out <dir>",
          "description": "output directory (default ./recordings/<screen_recording_uuid>)"
        },
        {
          "flags": "--video",
          "description": "also write a WebM per page view; plays in real time divided by --speed"
        },
        {
          "flags": "--speed <x>",
          "description": "video playback speed, 0.25 to 16 (default 1)"
        },
        {
          "flags": "--skip-inactive",
          "description": "skip idle stretches in the video"
        },
        {
          "flags": "--show-input",
          "description": "print what the visitor typed in the timeline (password fields stay hidden)"
        },
        {
          "flags": "--chrome <path>",
          "description": "Chrome executable, when Chrome is not installed in the usual place"
        },
        {
          "flags": "--audit-log <file>",
          "description": "append one JSON line per page view fetched or reused; no event data is written"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf recordings status",
      "usage": "sf recordings status",
      "description": "Say whether screen recording is on for the storefront, with its trial, cost and session counts",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf recordings enable",
      "usage": "sf recordings enable",
      "description": "Start recording real shoppers' sessions on the storefront, only when the merchant asks",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing whether live shoppers are recorded"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf recordings disable",
      "usage": "sf recordings disable",
      "description": "Stop recording shoppers' sessions on the storefront",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing whether live shoppers are recorded"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf experiments",
      "usage": "sf experiments",
      "description": "Start, watch and end StoreFront Experiments on pages and between pages",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments objectives",
      "usage": "sf experiments objectives",
      "description": "List the objectives an experiment can optimize",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments list",
      "usage": "sf experiments list",
      "description": "List experiments with their statistics",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--status <status>",
          "description": "Running or Ended"
        },
        {
          "flags": "--type <type>",
          "description": "page, url, theme or openai"
        },
        {
          "flags": "--path <path>",
          "description": "only experiments on this page"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments get",
      "usage": "sf experiments get <experimentOid>",
      "description": "Read one experiment's statistics, with an assessment of whether to act",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--daily",
          "description": "include each variation's daily rows"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments start-page",
      "usage": "sf experiments start-page",
      "description": "Start the experiment element saved in a page body",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "page whose body holds the experiment element"
        },
        {
          "flags": "--widget <id>",
          "description": "id of the experiment element"
        },
        {
          "flags": "--slot <name>",
          "description": "body file name without .cjson (default: \"body\")"
        },
        {
          "flags": "--live",
          "description": "acknowledge splitting live visitors"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments start-url",
      "usage": "sf experiments start-url <file>",
      "description": "Start a split between existing pages from a JSON spec",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--live",
          "description": "acknowledge splitting live visitors"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command, with the same spec"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments pause",
      "usage": "sf experiments pause <experimentOid>",
      "description": "Stop sending new visitors to a variation (not variation 0)",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--variation <n>",
          "description": "variation number"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live split"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments resume",
      "usage": "sf experiments resume <experimentOid>",
      "description": "Send new visitors to a paused variation again",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--variation <n>",
          "description": "variation number"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live split"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf experiments end",
      "usage": "sf experiments end <experimentOid>",
      "description": "End an experiment with a winner, or without one",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--winner <n>",
          "description": "variation to declare the winner"
        },
        {
          "flags": "--no-winner",
          "description": "end without a winner"
        },
        {
          "flags": "--live",
          "description": "acknowledge changing a live split"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/experiments"
    },
    {
      "path": "sf menus",
      "usage": "sf menus",
      "description": "Read and replace a storefront's store menus, which are what a menu element renders",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf menus list",
      "usage": "sf menus list",
      "description": "List the store menus on a storefront, without their entries",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf menus pull",
      "usage": "sf menus pull <code>",
      "description": "Write a menu and its baseline to a new local file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "local file to create; never overwritten"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf menus push",
      "usage": "sf menus push <file>",
      "description": "Replace a store menu with a local file; always live",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--create",
          "description": "create a menu for a code that does not exist yet; requires an unused baseline path"
        },
        {
          "flags": "--live",
          "description": "acknowledge that a store menu renders on every page; always required"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/menus-search-and-site-settings"
    },
    {
      "path": "sf containers",
      "usage": "sf containers",
      "description": "Read and replace the containers that are stored as rows rather than files",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf containers list",
      "usage": "sf containers list",
      "description": "List the item containers on the account; the only verb that answers which exist",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--item-id <id>",
          "description": "one item, by the merchant item ID a storefront carries"
        },
        {
          "flags": "--item-oid <oid>",
          "description": "one item, by OID; pass this or --item-id, not both"
        },
        {
          "flags": "--name <name>",
          "description": "one slot name, matched without regard to case"
        },
        {
          "flags": "--max-results <n>",
          "description": "page size, 1 through 500"
        },
        {
          "flags": "--offset <n>",
          "description": "rows to skip"
        },
        {
          "flags": "--all",
          "description": "walk every page instead of returning one"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf containers pull",
      "usage": "sf containers pull <file>",
      "description": "Write a container and its baseline to a new local file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--owner-type <type>",
          "description": "one of item, itemid, upsell, email, postcardfront, postcardback"
        },
        {
          "flags": "--owner-id <id>",
          "description": "item or upsell OID, merchant item ID for itemid, or ESP uuid"
        },
        {
          "flags": "--name <name>",
          "description": "slot name; item owners only"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf containers push",
      "usage": "sf containers push <file>",
      "description": "Replace a container with the file you pulled (it needs the .sf.json baseline beside it), or create one with --create",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--owner-type <type>",
          "description": "one of item, itemid, upsell, email, postcardfront, postcardback"
        },
        {
          "flags": "--owner-id <id>",
          "description": "item or upsell OID, merchant item ID for itemid, or ESP uuid"
        },
        {
          "flags": "--name <name>",
          "description": "slot name; item owners only"
        },
        {
          "flags": "--comment <text>",
          "description": "history comment recorded with the write"
        },
        {
          "flags": "--allow-warnings",
          "description": "store the container even if validation returns warnings"
        },
        {
          "flags": "--create",
          "description": "create a container that does not exist yet; requires an unused baseline path, and is refused if one is already there"
        },
        {
          "flags": "--remap-ids",
          "description": "with --create: give every widget a freshly reserved id and rewrite every reference to it, for copying a container to another owner"
        },
        {
          "flags": "--dry-run",
          "description": "make every check (the baseline, validation, and that the server still holds what you pulled) and write nothing; not with --create"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf containers versions",
      "usage": "sf containers versions",
      "description": "List a container's history in the server's order",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--owner-type <type>",
          "description": "one of item, itemid, upsell, email, postcardfront, postcardback"
        },
        {
          "flags": "--owner-id <id>",
          "description": "item or upsell OID, merchant item ID for itemid, or ESP uuid"
        },
        {
          "flags": "--name <name>",
          "description": "slot name; item owners only"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf containers version",
      "usage": "sf containers version <history-oid>",
      "description": "Read one earlier version's CJSON, and what a revert to it would change, without reverting",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--owner-type <type>",
          "description": "one of item, itemid, upsell, email, postcardfront, postcardback"
        },
        {
          "flags": "--owner-id <id>",
          "description": "item or upsell OID, merchant item ID for itemid, or ESP uuid"
        },
        {
          "flags": "--name <name>",
          "description": "slot name; item owners only"
        },
        {
          "flags": "--out <file>",
          "description": "write the version's CJSON to this new file"
        },
        {
          "flags": "--compare-current",
          "description": "also read the live container and list the widget ids a revert would bring back or remove"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf containers revert",
      "usage": "sf containers revert",
      "description": "Restore a historical version; the restore is itself undoable",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--owner-type <type>",
          "description": "one of item, itemid, upsell, email, postcardfront, postcardback"
        },
        {
          "flags": "--owner-id <id>",
          "description": "item or upsell OID, merchant item ID for itemid, or ESP uuid"
        },
        {
          "flags": "--name <name>",
          "description": "slot name; item owners only"
        },
        {
          "flags": "--history-oid <oid>",
          "description": "container_history_oid from 'versions'"
        },
        {
          "flags": "--comment <text>",
          "description": "history comment recorded with the restore"
        },
        {
          "flags": "--if-match <hash>",
          "description": "revert only if the container's current hash is this one, from 'versions' or the pull you reviewed; otherwise the hash read now is used. A removed container has no current hash: put it back without --if-match"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf template",
      "usage": "sf template",
      "description": "Find a page's template, copy one under a new name, or edit literal container parse lines in an explicitly selected template",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template find",
      "usage": "sf template find",
      "description": "Show the templates a page is set to use and their theme file paths; fails if the API does not say",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--uri <path>",
          "description": "catalog page path, such as /shop/"
        },
        {
          "flags": "--theme <oid>",
          "description": "map to this theme's files instead of the active theme's"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template resolve",
      "usage": "sf template resolve <name>",
      "description": "Show which file a template name renders, from the storefront's own template search",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "resolve in this theme instead of the active theme"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template wire",
      "usage": "sf template wire",
      "description": "wire a container parse; all pages using the template are affected",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--template <path>",
          "description": "absolute theme/templates .vm path, selected explicitly"
        },
        {
          "flags": "--parse <path>",
          "description": "literal /containers/<name>.vm reference"
        },
        {
          "flags": "--if-match <hash>",
          "description": "SHA-256 from a prior reviewed template read"
        },
        {
          "flags": "--before <path>",
          "description": "insert before this exact parse path (wire/move)"
        },
        {
          "flags": "--after <path>",
          "description": "insert after this exact parse path (wire/move)"
        },
        {
          "flags": "--live",
          "description": "acknowledge writing an active theme; requires publish permission"
        },
        {
          "flags": "--dry-run",
          "description": "validate and describe the edit without writing or asking anyone"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why the template changes (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template unwire",
      "usage": "sf template unwire",
      "description": "unwire a container parse; all pages using the template are affected",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--template <path>",
          "description": "absolute theme/templates .vm path, selected explicitly"
        },
        {
          "flags": "--parse <path>",
          "description": "literal /containers/<name>.vm reference"
        },
        {
          "flags": "--if-match <hash>",
          "description": "SHA-256 from a prior reviewed template read"
        },
        {
          "flags": "--before <path>",
          "description": "insert before this exact parse path (wire/move)"
        },
        {
          "flags": "--after <path>",
          "description": "insert after this exact parse path (wire/move)"
        },
        {
          "flags": "--live",
          "description": "acknowledge writing an active theme; requires publish permission"
        },
        {
          "flags": "--dry-run",
          "description": "validate and describe the edit without writing or asking anyone"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why the template changes (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template move",
      "usage": "sf template move",
      "description": "move a container parse; all pages using the template are affected",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--template <path>",
          "description": "absolute theme/templates .vm path, selected explicitly"
        },
        {
          "flags": "--parse <path>",
          "description": "literal /containers/<name>.vm reference"
        },
        {
          "flags": "--if-match <hash>",
          "description": "SHA-256 from a prior reviewed template read"
        },
        {
          "flags": "--before <path>",
          "description": "insert before this exact parse path (wire/move)"
        },
        {
          "flags": "--after <path>",
          "description": "insert after this exact parse path (wire/move)"
        },
        {
          "flags": "--live",
          "description": "acknowledge writing an active theme; requires publish permission"
        },
        {
          "flags": "--dry-run",
          "description": "validate and describe the edit without writing or asking anyone"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why the template changes (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template create",
      "usage": "sf template create",
      "description": "Copy a page template under a new name, so one page can have its own layout",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--from <name>",
          "description": "the template to copy, such as template_page.vm"
        },
        {
          "flags": "--to <name>",
          "description": "the new template's file name, such as template_page_landing.vm"
        },
        {
          "flags": "--live",
          "description": "acknowledge writing the active theme; requires publish permission"
        },
        {
          "flags": "--dry-run",
          "description": "check both names and show the copy without writing or asking anyone"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why the copy is needed (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf template delete",
      "usage": "sf template delete",
      "description": "Delete an unused page template the active theme itself holds, such as one 'sf template create' made",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <name>",
          "description": "the template's file name, such as template_page_landing.vm"
        },
        {
          "flags": "--dry-run",
          "description": "check the template and show what would be deleted, without asking anyone"
        },
        {
          "flags": "--live",
          "description": "required to delete: acknowledge removing a file of the active theme"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why this template should go (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/pages-and-themes"
    },
    {
      "path": "sf locate",
      "usage": "sf locate <targets...>",
      "description": "Resolve a heatmap selector or widget id, on one page, to the container file and widget it names",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--uri <path>",
          "description": "page path, such as /lp/offer/"
        },
        {
          "flags": "--theme <oid>",
          "description": "resolve in this theme instead of the active theme"
        },
        {
          "flags": "--search-theme",
          "description": "also read every container under every theme resource path, to find copies this page does not reach (one read per container)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "sf files",
      "usage": "sf files",
      "description": "List, read, write, delete, upload, and restore storefront files",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files validate",
      "usage": "sf files validate <local>",
      "description": "Validate theme JSON offline against the bundled partial contract; no sign-in or writes",
      "options": [
        {
          "flags": "--as <type>",
          "description": "theme JSON contract (choices: \"changeLog\", \"settings\")"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files upload",
      "usage": "sf files upload <local>",
      "description": "Upload a matching image (.jpg, .jpeg, .png, .gif, .webp, .avif, .svg), video (.mp4, .webm, .mov), font (.woff, .woff2, .ttf, .otf, .eot) or .pdf asset; preserve staged bytes for an explicit conflict retry",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--to <path>",
          "description": "absolute destination file path"
        },
        {
          "flags": "--if-match <hash>",
          "description": "reviewed current hash for replacing an existing file"
        },
        {
          "flags": "--live",
          "description": "acknowledge an active-theme or shared asset write"
        },
        {
          "flags": "--state <file>",
          "description": "recovery state file (default: <local>.upload.json)"
        },
        {
          "flags": "--resume",
          "description": "reuse a staged key after 428/412; requires --if-match"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files put",
      "usage": "sf files put <local>",
      "description": "Write a local .json or .css file, such as a SurveyJS survey definition or override.css, or a reviewed and approved .js, .vm or .html",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--to <path>",
          "description": "absolute destination .json, .css, .js, .mjs, .vm or .html path"
        },
        {
          "flags": "--create",
          "description": "create a new file; refused by the server if one already exists"
        },
        {
          "flags": "--if-match <hash>",
          "description": "replace the version with this hash, from 'sf files get --format json'"
        },
        {
          "flags": "--live",
          "description": "required acknowledgement for every text-file write, including draft themes"
        },
        {
          "flags": "--comment <text>",
          "description": "note recorded against the new version"
        },
        {
          "flags": "--allow-script",
          "description": "write a .js or .mjs file; UltraCart reviews it and the signed-in person approves it"
        },
        {
          "flags": "--allow-template",
          "description": "write a .vm or .html file inside a theme; UltraCart reviews it and the signed-in person approves it"
        },
        {
          "flags": "--dry-run",
          "description": "for a template: show the diff and the Velocity validation, and request no approval"
        },
        {
          "flags": "--reason <text>",
          "description": "for a script or template: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "for a script or template: finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "for a script or template: how long to wait before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files delete",
      "usage": "sf files delete <path>",
      "description": "Delete one storefront file with a current If-Match hash",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--if-match <hash>",
          "description": "pin the hash reviewed in 'sf files versions'; otherwise read the current version's hash now"
        },
        {
          "flags": "--live",
          "description": "required acknowledgement for every delete"
        },
        {
          "flags": "--reason <text>",
          "description": "one sentence for the person approving: why this file should go (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "how long to wait for the decision before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files list",
      "usage": "sf files list [path]",
      "description": "List one storefront directory",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--path <path>",
          "description": "alias for the positional directory path"
        },
        {
          "flags": "--directory-oid <oid>",
          "description": "storefront file-system directory oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "resolve a relative path from this theme"
        },
        {
          "flags": "--max-entries <count>",
          "description": "maximum entries returned by the server"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files get",
      "usage": "sf files get <path>",
      "description": "Read the current or an earlier version of a text storefront file",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file-version <number>",
          "description": "historical file version number"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files versions",
      "usage": "sf files versions <path>",
      "description": "List a file's version history, newest first",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files search",
      "usage": "sf files search",
      "description": "Find storefront files by name, contents or state, on the server",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--name <patterns>",
          "description": "file name patterns, comma separated, * wildcards, e.g. '*.vm,header*'"
        },
        {
          "flags": "--text <text>",
          "description": "text to find inside text files"
        },
        {
          "flags": "--path <dir>",
          "description": "only this directory and below, e.g. /themes/elements/"
        },
        {
          "flags": "--case-sensitive",
          "description": "with --text: match case exactly"
        },
        {
          "flags": "--no-recurse",
          "description": "with --path: that directory only"
        },
        {
          "flags": "--invalid",
          "description": "only files that failed Velocity validation"
        },
        {
          "flags": "--merge-conflicts",
          "description": "only files with an unresolved theme merge conflict (these block activation)"
        },
        {
          "flags": "--modified-since <date>",
          "description": "only files changed at or after this ISO 8601 date or time"
        },
        {
          "flags": "--max-results <count>",
          "description": "results per page (the server caps it)"
        },
        {
          "flags": "--offset <count>",
          "description": "results to skip: the --offset a truncated search printed"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files download",
      "usage": "sf files download <path>",
      "description": "Save a storefront file's exact bytes to a new local file: any type, from any theme",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "new local file to write"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf files revert",
      "usage": "sf files revert <path>",
      "description": "Restore an earlier version of a file; the restore is a new version, so it is undoable too",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--file-version <number>",
          "description": "version to restore, from 'sf files versions'"
        },
        {
          "flags": "--if-match <hash>",
          "description": "current version's hash from 'sf files versions'"
        },
        {
          "flags": "--live",
          "description": "acknowledge reverting a page body or a file in the active theme"
        },
        {
          "flags": "--allow-removals",
          "description": "acknowledge widget IDs the restored version does not have"
        },
        {
          "flags": "--comment <text>",
          "description": "history comment recorded with the restore"
        },
        {
          "flags": "--allow-template",
          "description": "revert a .vm or .html file; UltraCart reviews the restored version and the signed-in person approves it"
        },
        {
          "flags": "--reason <text>",
          "description": "for a script or template: one sentence for the person approving (shown as unverified)"
        },
        {
          "flags": "--approval <id>",
          "description": "for a script or template: finish with an approval from an earlier run of this same command"
        },
        {
          "flags": "--wait <seconds>",
          "description": "for a script or template: how long to wait before exiting with code 3 (0-600, default 90)"
        },
        {
          "flags": "--delegate <email>",
          "description": "hand the approval to this colleague on the account, who decides with their own code; use the address the person gives, never a guess"
        }
      ],
      "approval": true,
      "page": "/developer/storefront/agent-toolchain/capabilities/files-and-assets"
    },
    {
      "path": "sf pull",
      "usage": "sf pull <path>",
      "description": "Read container CJSON into a new local file with its hash and baseline",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--out <file>",
          "description": "new local CJSON file (never overwrites); defaults to the remote file's name in the current directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf push",
      "usage": "sf push <file>",
      "description": "Validate and write a whole container CJSON document using its saved baseline",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--to <path>",
          "description": "absolute .cjson path; defaults to the baseline's destination, required with --create"
        },
        {
          "flags": "--create",
          "description": "create a new remote file without an existing local baseline"
        },
        {
          "flags": "--live",
          "description": "acknowledge writing into the active theme or live page content"
        },
        {
          "flags": "--theme <oid>",
          "description": "compile against this theme instead of the active one; only for paths outside every theme"
        },
        {
          "flags": "--allow-removals",
          "description": "acknowledge widget IDs removed since the saved baseline"
        },
        {
          "flags": "--allow-unknown-config-keys",
          "description": "report unknown or legacy config keys added since the baseline as warnings instead of errors"
        },
        {
          "flags": "--dry-run",
          "description": "run every check and report the delta and any conflict without writing"
        },
        {
          "flags": "--verbose",
          "description": "list warnings on unchanged widgets instead of counting them"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf render",
      "usage": "sf render <file> [selector]",
      "description": "Render one local CJSON node against a remote storefront theme without writing",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme oid"
        },
        {
          "flags": "--uri <path>",
          "description": "storefront URI for page-relative rendering (the server requires it)"
        },
        {
          "flags": "--group <path>",
          "description": "catalog group path for group-bound elements"
        },
        {
          "flags": "--item <id>",
          "description": "item id for item-bound elements"
        },
        {
          "flags": "--order <id>",
          "description": "a test order to render order elements with: an order id, latest-test, or latest-test-digital for one with downloads (see 'sf orders test-orders'); a real customer order is refused"
        },
        {
          "flags": "--language <code>",
          "description": "three-letter language code (ISO 639-2 bibliographic, with UltraCart exceptions such as ESP for Spanish), enabled on the storefront (see 'sf i18n languages'); defaults to ENG. A render never translates: it shows the translations already stored, and untranslated_count says how many strings stayed English"
        },
        {
          "flags": "--allow-default-context",
          "description": "explicitly allow the server to default missing group or item context"
        },
        {
          "flags": "--edit-mode",
          "description": "render every branch the way the builder shows it, instead of what a shopper sees"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf preview",
      "usage": "sf preview",
      "description": "Stage theme containers in a preview session and open it in any browser",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf preview diff",
      "usage": "sf preview diff",
      "description": "Compare full-page live and staged screenshots before publishing",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme to compare, which may be inactive"
        },
        {
          "flags": "--session <id>",
          "description": "staged preview session from 'sf preview start'"
        },
        {
          "flags": "--out <directory>",
          "description": "output directory (created if absent); existing files are never replaced"
        },
        {
          "flags": "--path <path>",
          "description": "storefront page to compare (default: \"/\")"
        },
        {
          "flags": "--viewport <widths>",
          "description": "width in pixels, or a comma list such as 1440,390 (default 1440)"
        },
        {
          "flags": "--ignore <selector>",
          "description": "mask a dynamic region on both pages; repeat for up to 20 CSS selectors (default: [])"
        },
        {
          "flags": "--chrome <path>",
          "description": "Chrome executable, when Chrome is not installed in the usual place"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf preview start",
      "usage": "sf preview start",
      "description": "Open a preview session; it expires after 8 hours",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf preview stage",
      "usage": "sf preview stage",
      "description": "Replace a preview session's containers with local theme files, page bodies and item containers",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--session <id>",
          "description": "preview session id from 'sf preview start'"
        },
        {
          "flags": "--file <local=remote>",
          "description": "local .cjson file and the theme file or page body it stands in for, as <local>=<remote .cjson path>; repeat for each file (default: [])"
        },
        {
          "flags": "--item <local>",
          "description": "local item container file pulled with 'sf containers pull'; repeat for each (default: [])"
        },
        {
          "flags": "--upsell <local=offer oid>",
          "description": "local upsell offer page and the offer it stands in for, as <local>=<offer oid>; repeat for each. Open it with 'sf preview open --upsell <offer oid>' (default: [])"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme to preview when nothing staged is inside a theme; defaults to the active theme"
        },
        {
          "flags": "--tracking-html <file>",
          "description": "custom tracking HTML to run instead of the live slot on pages opened through this session's preview access link; an empty file unstages it"
        },
        {
          "flags": "--conversion-html <file>",
          "description": "custom conversion HTML to run instead of the live slot on a test order's receipt opened through the preview access link (its first load, paid with a test method that doesn't skip conversion pixels); an empty file unstages it"
        },
        {
          "flags": "--allow-invalid",
          "description": "stage a diagnostic preview despite local or server CJSON validation errors"
        },
        {
          "flags": "--allow-unknown-config-keys",
          "description": "report unknown or legacy config keys added since the baseline (the pull record beside the file, or else the server's current copy of a --file target) as warnings instead of errors"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf preview open",
      "usage": "sf preview open",
      "description": "Print a single-use link that opens the storefront in preview in any browser",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "required theme to show, which may be inactive"
        },
        {
          "flags": "--session <id>",
          "description": "preview session to show; omit to show saved containers with nothing staged"
        },
        {
          "flags": "--path <path>",
          "description": "storefront page to land on (default: \"/\")"
        },
        {
          "flags": "--variation <n>",
          "description": "show this experiment variation on the landing page (adds expvid)"
        },
        {
          "flags": "--upsell <offer oid>",
          "description": "land on this upsell offer's page as checkout shows it, even while the offer is switched off; Yes/No do nothing in preview"
        },
        {
          "flags": "--pre",
          "description": "with --upsell, frame the offer as the pre-checkout pop-up"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf preview end",
      "usage": "sf preview end",
      "description": "Delete a preview session before it expires",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--session <id>",
          "description": "preview session id from 'sf preview start'"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "sf snapshot",
      "usage": "sf snapshot",
      "description": "Record how a storefront is laid out at handoff, and compare it with the live site later",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/snapshots-and-reports"
    },
    {
      "path": "sf snapshot take",
      "usage": "sf snapshot take <dir>",
      "description": "Write a read-only snapshot of a storefront's layout to a new or empty directory",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme to record (default: the active theme)"
        },
        {
          "flags": "--no-content",
          "description": "record .cjson files by hash only, without saving their content"
        },
        {
          "flags": "--wait <seconds>",
          "description": "while UltraCart's rate limit is reached, wait up to this many seconds in total for room, as long as the server's Retry-After says (0-3600, default 600); when room comes back later than that, pause with exit 3"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/snapshots-and-reports"
    },
    {
      "path": "sf snapshot diff",
      "usage": "sf snapshot diff <old> [new]",
      "description": "Compare a snapshot with a newer one or with the live storefront; exit 1 when they differ",
      "options": [
        {
          "flags": "--live",
          "description": "compare with the storefront as it is now"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid; must match the snapshot's (default: the snapshot's)"
        },
        {
          "flags": "--theme <oid>",
          "description": "with --live, the theme to compare (default: the snapshot's theme)"
        },
        {
          "flags": "--wait <seconds>",
          "description": "while UltraCart's rate limit is reached, wait up to this many seconds in total for room, as long as the server's Retry-After says (0-3600, default 600); when room comes back later than that, pause with exit 3"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/snapshots-and-reports"
    },
    {
      "path": "sf report",
      "usage": "sf report <snapshot>",
      "description": "Write a shareable PDF of a storefront: its pages, menus and redirects, with desktop and mobile screenshots",
      "options": [
        {
          "flags": "--out <file>",
          "description": "new .pdf file to write; never overwritten"
        },
        {
          "flags": "--storefront <oid>",
          "description": "storefront oid; must match the snapshot's (default: the snapshot's)"
        },
        {
          "flags": "--theme <oid>",
          "description": "theme to capture (default: the snapshot's theme)"
        },
        {
          "flags": "--session <id>",
          "description": "capture a staged preview session from 'sf preview start' instead of the live site"
        },
        {
          "flags": "--all",
          "description": "capture every page in the snapshot"
        },
        {
          "flags": "--pages <path>",
          "description": "capture this page; repeat for more (default: [])"
        },
        {
          "flags": "--max-pages <n>",
          "description": "refuse more pages than this (default 50)"
        },
        {
          "flags": "--title <text>",
          "description": "the cover's heading (default: the store's host name)"
        },
        {
          "flags": "--hide-overlays",
          "description": "hide fixed and sticky elements, such as a sticky header or chat button"
        },
        {
          "flags": "--chrome <path>",
          "description": "Chrome executable, when Chrome is not installed in the usual place"
        },
        {
          "flags": "--wait <seconds>",
          "description": "while UltraCart's rate limit is reached, wait up to this many seconds in total for room, as long as the server's Retry-After says (0-3600, default 600); when room comes back later than that, pause with exit 3"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/snapshots-and-reports"
    },
    {
      "path": "schema",
      "usage": "schema",
      "description": "Discover widget types and their configuration contracts",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "schema list",
      "usage": "schema list",
      "description": "List or search widget types",
      "options": [
        {
          "flags": "--search <text>",
          "description": "search type, friendly name, group, key, or description"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "schema show",
      "usage": "schema show <widget-type>",
      "description": "Show an element's placement and config metadata",
      "options": [
        {
          "flags": "--raw",
          "description": "return the source config schema"
        },
        {
          "flags": "--keys <keys>",
          "description": "select exact comma-separated config keys (JSON only; trims whitespace, deduplicates in catalog order)"
        },
        {
          "flags": "--placement <mode>",
          "description": "compact omits unrestricted child expansion (JSON only; explicit lists stay complete)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "schema children",
      "usage": "schema children <widget-type>",
      "description": "List types documented as children of an element",
      "options": [
        {
          "flags": "--search <text>",
          "description": ""
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "schema parents",
      "usage": "schema parents <widget-type>",
      "description": "List types documented as required ancestry for an element",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "catalog",
      "usage": "catalog",
      "description": "Inspect and verify the packaged StoreFront evidence catalog",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "catalog info",
      "usage": "catalog info",
      "description": "Show catalog identity, provenance, and package location",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "catalog verify",
      "usage": "catalog verify",
      "description": "Load every schema and document and verify the catalog integrity digest",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "element",
      "usage": "element",
      "description": "Search and learn the purpose and behavior of StoreFront elements",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "element search",
      "usage": "element search <query>",
      "description": "Rank elements using type, metadata, authored docs, and config descriptions; an element named exactly by the query ranks first, then, when no element matches the whole query, one named by one of its words",
      "options": [
        {
          "flags": "--limit <count>",
          "description": "maximum results (default: 20)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "element explain",
      "usage": "element explain <widget-type>",
      "description": "Return a bounded purpose, placement, runtime, and gotchas packet",
      "options": [
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "element docs",
      "usage": "element docs <widget-type>",
      "description": "Read one element document or a named section with bounded output",
      "options": [
        {
          "flags": "--section <name>",
          "description": "section id or alias such as purpose, runtime, or gotchas"
        },
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        },
        {
          "flags": "--full",
          "description": "return the complete imported Markdown without a context budget"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "guide",
      "usage": "guide",
      "description": "Search and read the packaged agent guide, tutorials, and recipes",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "guide list",
      "usage": "guide list",
      "description": "List packaged guides",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "guide search",
      "usage": "guide search <query>",
      "description": "Search across the agent guide, tutorials, and recipes",
      "options": [
        {
          "flags": "--limit <count>",
          "description": "maximum results (default: 20)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "guide show",
      "usage": "guide show <guide-id>",
      "description": "Read a packaged guide with bounded output",
      "options": [
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        },
        {
          "flags": "--full",
          "description": "return the complete Markdown without a context budget"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "cjson",
      "usage": "cjson",
      "description": "Create, inspect, validate, and edit local CJSON documents",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson init",
      "usage": "cjson init <file>",
      "description": "Create a new root CJSON document",
      "options": [
        {
          "flags": "--type <widget-type>",
          "description": "root element type (default: \"container\")"
        },
        {
          "flags": "--id <id>",
          "description": ""
        },
        {
          "flags": "--title <title>",
          "description": ""
        },
        {
          "flags": "--config <key=value>",
          "description": "set a config property; key@small|medium|large=value sets one breakpoint (default: [])"
        },
        {
          "flags": "--force",
          "description": "replace an existing file"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson tree",
      "usage": "cjson tree <file>",
      "description": "Print the hierarchy with canonical paths and stable IDs",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson inspect",
      "usage": "cjson inspect|get <file> <selector>",
      "description": "Read a bounded projection of one widget selected by canonical path or #id",
      "options": [
        {
          "flags": "--depth <levels>",
          "description": "include this many descendant levels (default: 0)"
        },
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        },
        {
          "flags": "--full",
          "description": "return the complete raw subtree without a context budget"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson context",
      "usage": "cjson context <file> <selector>",
      "description": "Build a bounded agent packet with widget, schema, placement, and diagnostics",
      "options": [
        {
          "flags": "--authoring",
          "description": "include existing guidance for visible widget types"
        },
        {
          "flags": "--types <types>",
          "description": "comma-separated visible types to include (requires --authoring)"
        },
        {
          "flags": "--intent <text>",
          "description": "guide search intent (requires --authoring)"
        },
        {
          "flags": "--depth <levels>",
          "description": "include this many descendant levels (default: 0)"
        },
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson find",
      "usage": "cjson find <file>",
      "description": "Search widgets by type, title, or serialized content",
      "options": [
        {
          "flags": "--type <widget-type>",
          "description": ""
        },
        {
          "flags": "--title <text>",
          "description": ""
        },
        {
          "flags": "--text <text>",
          "description": ""
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson validate",
      "usage": "cjson validate <file>",
      "description": "Validate hard tree invariants and lint advisory bundle rules. Reads the file alone, with no baseline, so it cannot tell what you authored from what you pulled: advisory value mismatches stay warnings; authoritative contracts and hard invariants still produce errors. 0 errors here is not a prediction that sf push or sf containers push will succeed - a push diffs against the baseline and holds keys you set, and widgets you added, retyped or moved, to stricter rules, so a placement warning here (context_parent_chain, context_element_not_allowed, context_postcard_side) is refused on push when you put the widget there",
      "options": [
        {
          "flags": "--limit <count>",
          "description": "maximum diagnostics to print (default: 100)"
        },
        {
          "flags": "--all",
          "description": "print every diagnostic"
        },
        {
          "flags": "--context <editor>",
          "description": "destination editor: site, email or postcard; otherwise infer from the top layout"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson apply",
      "usage": "cjson apply <file>",
      "description": "Apply an ordered JSON plan as one atomic document mutation",
      "options": [
        {
          "flags": "--plan <file>",
          "description": "versioned JSON batch plan"
        },
        {
          "flags": "--replace-translations",
          "description": "allow update operations that drop languages from a stored translation map"
        },
        {
          "flags": "--dry-run",
          "description": "validate and print a receipt without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson add",
      "usage": "cjson add <file>",
      "description": "Create a widget and attach it under a selected parent",
      "options": [
        {
          "flags": "--parent <selector>",
          "description": ""
        },
        {
          "flags": "--type <widget-type>",
          "description": ""
        },
        {
          "flags": "--id <id>",
          "description": ""
        },
        {
          "flags": "--title <title>",
          "description": "builder hierarchy label (default: the element type)"
        },
        {
          "flags": "--at <index>",
          "description": "insert before this child index"
        },
        {
          "flags": "--config <key=value>",
          "description": "set a config property; key@small|medium|large=value sets one breakpoint (default: [])"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson update",
      "usage": "cjson update <file> <selector>",
      "description": "Update widget fields with JSON Pointer assignments",
      "options": [
        {
          "flags": "--set <json-pointer=value>",
          "description": "set a field (default: [])"
        },
        {
          "flags": "--unset <json-pointer>",
          "description": "remove a config key, like /config/<key> (--set /config/<key>= writes an empty string) (default: [])"
        },
        {
          "flags": "--replace-translations",
          "description": "allow a write that drops languages from a stored translation map"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson translate",
      "usage": "cjson translate <file> <selector> <property>",
      "description": "Set one multilingual setting on one widget in any number of languages; languages not named are left alone",
      "options": [
        {
          "flags": "--set <code=text>",
          "description": "a language and its text, such as ESP=Acerca de; repeat for several (default: [])"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson translations",
      "usage": "cjson translations <file> [selector]",
      "description": "List the multilingual settings with text in a file: which are plain English and which languages each map has",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson remove",
      "usage": "cjson remove <file> <selector>",
      "description": "Delete a selected widget and its subtree",
      "options": [
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "cjson move",
      "usage": "cjson move <file> <selector>",
      "description": "Move a selected widget and its subtree",
      "options": [
        {
          "flags": "--parent <selector>",
          "description": ""
        },
        {
          "flags": "--at <index>",
          "description": "insert before this child index"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "tree",
      "usage": "tree <file>",
      "description": "Print the hierarchy with canonical paths and stable IDs",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "inspect",
      "usage": "inspect|get <file> <selector>",
      "description": "Read a bounded projection of one widget selected by canonical path or #id",
      "options": [
        {
          "flags": "--depth <levels>",
          "description": "include this many descendant levels (default: 0)"
        },
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        },
        {
          "flags": "--full",
          "description": "return the complete raw subtree without a context budget"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "context",
      "usage": "context <file> <selector>",
      "description": "Build a bounded agent packet with widget, schema, placement, and diagnostics",
      "options": [
        {
          "flags": "--authoring",
          "description": "include existing guidance for visible widget types"
        },
        {
          "flags": "--types <types>",
          "description": "comma-separated visible types to include (requires --authoring)"
        },
        {
          "flags": "--intent <text>",
          "description": "guide search intent (requires --authoring)"
        },
        {
          "flags": "--depth <levels>",
          "description": "include this many descendant levels (default: 0)"
        },
        {
          "flags": "--budget <bytes>",
          "description": "maximum UTF-8 bytes for the JSON packet (default: 12000)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "find",
      "usage": "find <file>",
      "description": "Search widgets by type, title, or serialized content",
      "options": [
        {
          "flags": "--type <widget-type>",
          "description": ""
        },
        {
          "flags": "--title <text>",
          "description": ""
        },
        {
          "flags": "--text <text>",
          "description": ""
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "validate",
      "usage": "validate <file>",
      "description": "Validate hard tree invariants and lint advisory bundle rules. Reads the file alone, with no baseline, so it cannot tell what you authored from what you pulled: advisory value mismatches stay warnings; authoritative contracts and hard invariants still produce errors. 0 errors here is not a prediction that sf push or sf containers push will succeed - a push diffs against the baseline and holds keys you set, and widgets you added, retyped or moved, to stricter rules, so a placement warning here (context_parent_chain, context_element_not_allowed, context_postcard_side) is refused on push when you put the widget there",
      "options": [
        {
          "flags": "--limit <count>",
          "description": "maximum diagnostics to print (default: 100)"
        },
        {
          "flags": "--all",
          "description": "print every diagnostic"
        },
        {
          "flags": "--context <editor>",
          "description": "destination editor: site, email or postcard; otherwise infer from the top layout"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "apply",
      "usage": "apply <file>",
      "description": "Apply an ordered JSON plan as one atomic document mutation",
      "options": [
        {
          "flags": "--plan <file>",
          "description": "versioned JSON batch plan"
        },
        {
          "flags": "--replace-translations",
          "description": "allow update operations that drop languages from a stored translation map"
        },
        {
          "flags": "--dry-run",
          "description": "validate and print a receipt without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "add",
      "usage": "add <file>",
      "description": "Create a widget and attach it under a selected parent",
      "options": [
        {
          "flags": "--parent <selector>",
          "description": ""
        },
        {
          "flags": "--type <widget-type>",
          "description": ""
        },
        {
          "flags": "--id <id>",
          "description": ""
        },
        {
          "flags": "--title <title>",
          "description": "builder hierarchy label (default: the element type)"
        },
        {
          "flags": "--at <index>",
          "description": "insert before this child index"
        },
        {
          "flags": "--config <key=value>",
          "description": "set a config property; key@small|medium|large=value sets one breakpoint (default: [])"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "update",
      "usage": "update <file> <selector>",
      "description": "Update widget fields with JSON Pointer assignments",
      "options": [
        {
          "flags": "--set <json-pointer=value>",
          "description": "set a field (default: [])"
        },
        {
          "flags": "--unset <json-pointer>",
          "description": "remove a config key, like /config/<key> (--set /config/<key>= writes an empty string) (default: [])"
        },
        {
          "flags": "--replace-translations",
          "description": "allow a write that drops languages from a stored translation map"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "remove",
      "usage": "remove <file> <selector>",
      "description": "Delete a selected widget and its subtree",
      "options": [
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "move",
      "usage": "move <file> <selector>",
      "description": "Move a selected widget and its subtree",
      "options": [
        {
          "flags": "--parent <selector>",
          "description": ""
        },
        {
          "flags": "--at <index>",
          "description": "insert before this child index"
        },
        {
          "flags": "--dry-run",
          "description": "print the proposed document without writing"
        },
        {
          "flags": "--full",
          "description": "include the complete proposed document in dry-run output"
        },
        {
          "flags": "--allow-invalid",
          "description": "write even when hard validation errors remain"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/local-editing-workflow"
    },
    {
      "path": "warehouse",
      "usage": "warehouse",
      "description": "Run a bounded, audited read against the merchant's BigQuery warehouse",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "warehouse query",
      "usage": "warehouse query <sql>",
      "description": "Dry-run, check the ceiling and the dataset boundary, then run the query",
      "options": [
        {
          "flags": "--merchant <id>",
          "description": "merchant code, resolved to the ultracart-dw-<id> project"
        },
        {
          "flags": "--project <id>",
          "description": "explicit project id, for a warehouse that does not follow the convention"
        },
        {
          "flags": "--max-bytes <size>",
          "description": "scan ceiling, e.g. 20GiB or 500mb (default 20.0 GiB)"
        },
        {
          "flags": "--parameter <name:type:value>",
          "description": "query parameter, repeatable, passed through to bq (default: [])"
        },
        {
          "flags": "--audit-log <file>",
          "description": "append one JSON line per query to this file"
        },
        {
          "flags": "--max-rows <n>",
          "description": "the most rows to return (default 100); truncated: true says there were more"
        },
        {
          "flags": "--dry-run",
          "description": "report the estimate and the resolved tables without running the query"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/capabilities/analytics-and-tracking"
    },
    {
      "path": "recipe",
      "usage": "recipe",
      "description": "Capture native widget subtrees and instantiate local or built-in recipes",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "recipe list",
      "usage": "recipe list",
      "description": "List built-ins and top-level *.recipe.json files from ./recipes or --directory",
      "options": [
        {
          "flags": "--directory <path>",
          "description": "explicit project or shared recipe directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "recipe search",
      "usage": "recipe search <query>",
      "description": "Find recipes by name, description and tags; all query terms must match",
      "options": [
        {
          "flags": "--directory <path>",
          "description": "explicit project or shared recipe directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "recipe example",
      "usage": "recipe example [name]",
      "description": "Print a built-in recipe (native-editorial by default, or experiment-ab); save and customize it locally",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "recipe capture",
      "usage": "recipe capture <file> <selector>",
      "description": "Save a selected native widget and its children as a new local recipe file",
      "options": [
        {
          "flags": "--out <file>",
          "description": "explicit new recipe file; otherwise use the workspace recipes directory"
        },
        {
          "flags": "--name <name>",
          "description": "recipe name; defaults to selected widget title or type"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "recipe instantiate",
      "usage": "recipe instantiate <recipe-file> <file>",
      "description": "Emit an ordinary apply plan from a local recipe or a built-in (builtin:native-editorial, builtin:experiment-ab); writes no CJSON",
      "options": [
        {
          "flags": "--parent <selector>",
          "description": "target parent in the existing local document"
        },
        {
          "flags": "--ids <file>",
          "description": "JSON array of exactly as many reserved numeric IDs as the recipe has widgets, or the receipt from --format json sf ids (text output is not accepted)"
        },
        {
          "flags": "--params <file>",
          "description": "JSON parameter values; omitted values use recipe defaults"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/element-catalog-and-guides"
    },
    {
      "path": "workspace",
      "usage": "workspace",
      "description": "Manage project workspaces",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "workspace init",
      "usage": "workspace init [directory]",
      "description": "Initialize a project and select agent skills (documents: cjson init)",
      "options": [
        {
          "flags": "--target <agent>",
          "description": "repeat codex, claude, gemini, hermes; or all"
        },
        {
          "flags": "--hermes-home <path>",
          "description": "Hermes home for the hermes target (default: $HERMES_HOME, the active profile, or ~/.hermes)"
        },
        {
          "flags": "--no-input",
          "description": "never prompt"
        },
        {
          "flags": "--dry-run",
          "description": "validate and show all planned changes without writing"
        },
        {
          "flags": "--allow-downgrade",
          "description": "explicitly replace newer owned skills with this package version"
        },
        {
          "flags": "--verbose",
          "description": "list every file planned or written, even at a terminal"
        },
        {
          "flags": "--no-skills",
          "description": "explicitly disable skill integrations"
        },
        {
          "flags": "--recipes-dir <path>",
          "description": "workspace-relative recipe directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "init",
      "usage": "init [directory]",
      "description": "Initialize a project and select agent skills (documents: cjson init)",
      "options": [
        {
          "flags": "--target <agent>",
          "description": "repeat codex, claude, gemini, hermes; or all"
        },
        {
          "flags": "--hermes-home <path>",
          "description": "Hermes home for the hermes target (default: $HERMES_HOME, the active profile, or ~/.hermes)"
        },
        {
          "flags": "--no-input",
          "description": "never prompt"
        },
        {
          "flags": "--dry-run",
          "description": "validate and show all planned changes without writing"
        },
        {
          "flags": "--allow-downgrade",
          "description": "explicitly replace newer owned skills with this package version"
        },
        {
          "flags": "--verbose",
          "description": "list every file planned or written, even at a terminal"
        },
        {
          "flags": "--no-skills",
          "description": "explicitly disable skill integrations"
        },
        {
          "flags": "--recipes-dir <path>",
          "description": "workspace-relative recipe directory"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "skills",
      "usage": "skills",
      "description": "Install, refresh, remove, and inspect project agent skills",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "skills install",
      "usage": "skills install",
      "description": "Install or refresh the agent skill for the agents named with --target (claude, codex, gemini, hermes or all). Hermes Agent gets its copy in the Hermes home rather than the workspace.",
      "options": [
        {
          "flags": "--target <agent>",
          "description": "repeat codex, claude, gemini, hermes; or all"
        },
        {
          "flags": "--hermes-home <path>",
          "description": "Hermes home for the hermes target (default: $HERMES_HOME, the active profile, or ~/.hermes)"
        },
        {
          "flags": "--no-input",
          "description": "never prompt"
        },
        {
          "flags": "--dry-run",
          "description": "validate and show all planned changes without writing"
        },
        {
          "flags": "--allow-downgrade",
          "description": "explicitly replace newer owned skills with this package version"
        },
        {
          "flags": "--verbose",
          "description": "list every file planned or written, even at a terminal"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "skills remove",
      "usage": "skills remove",
      "description": "Remove the agent skill copies this CLI installed for the agents named with --target.",
      "options": [
        {
          "flags": "--target <agent>",
          "description": "repeat codex, claude, gemini, hermes; or all"
        },
        {
          "flags": "--hermes-home <path>",
          "description": "Hermes home for the hermes target (default: $HERMES_HOME, the active profile, or ~/.hermes)"
        },
        {
          "flags": "--no-input",
          "description": "never prompt"
        },
        {
          "flags": "--dry-run",
          "description": "validate and show all planned changes without writing"
        },
        {
          "flags": "--allow-downgrade",
          "description": "explicitly replace newer owned skills with this package version"
        },
        {
          "flags": "--verbose",
          "description": "list every file planned or written, even at a terminal"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "skills status",
      "usage": "skills status",
      "description": "Read-only inspection of observed skill copies; does not prove agent loading",
      "options": [
        {
          "flags": "--check",
          "description": "exit 3 on drift; plain status exits 0"
        },
        {
          "flags": "--hermes-home <path>",
          "description": "Hermes home to inspect (default: $HERMES_HOME, the active profile, or ~/.hermes)"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/install-and-set-up"
    },
    {
      "path": "docs",
      "usage": "docs",
      "description": "Capture and review documentation gaps locally, and submit them to UltraCart",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/troubleshooting"
    },
    {
      "path": "docs gap",
      "usage": "docs gap",
      "description": "Capture and review merchant-owned reports locally, with no network or sign-in; submit sends one to UltraCart for its staff to review, and status reads where it stands",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/troubleshooting"
    },
    {
      "path": "docs gap capture",
      "usage": "docs gap capture",
      "description": "Save a new report locally; never overwrite, fetch evidence, or send it",
      "options": [
        {
          "flags": "--title <text>",
          "description": "short description, at most 200 characters"
        },
        {
          "flags": "--url <url>",
          "description": "nearest documentation page (HTTP/HTTPS); omit if none exists"
        },
        {
          "flags": "--observed <text>",
          "description": "confirmed behavior or missing guidance"
        },
        {
          "flags": "--expected <text>",
          "description": "what the documentation should say"
        },
        {
          "flags": "--evidence <text>",
          "description": "repeat for sanitized evidence descriptions or links; files are not read"
        },
        {
          "flags": "--out <file>",
          "description": "new report file relative to cwd; default: docs-gaps/<unique-id>.gap.json under the working directory or --workspace"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/troubleshooting"
    },
    {
      "path": "docs gap review",
      "usage": "docs gap review <file>",
      "description": "Read a report without changing it; display contents and sensitive-data checks, never approve or send it",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/troubleshooting"
    },
    {
      "path": "docs gap submit",
      "usage": "docs gap submit <file>",
      "description": "Send a reviewed report to UltraCart, whose staff review it; needs a person's sign-in on this device",
      "options": [
        {
          "flags": "--storefront <oid>",
          "description": "the storefront the gap was found on, if any"
        },
        {
          "flags": "--dry-run",
          "description": "make every check and print the exact body, and send nothing"
        }
      ],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/troubleshooting"
    },
    {
      "path": "docs gap status",
      "usage": "docs gap status <report_id>",
      "description": "Where a submitted report stands: received, accepted, declined or fixed (read only)",
      "options": [],
      "approval": false,
      "page": "/developer/storefront/agent-toolchain/troubleshooting"
    }
  ]
}
