CLI reference / product / sync

stado product sync

Invocation

stado product sync [OPTIONS] --surface <surface>

Purpose

Reconcile installed surfaces against canonical origin/main

Required inputs and options

Input or optionContract
--catalog <catalog>Independent authoritative catalog path
--surface <surface>Product installation surface [possible values: cli, desktop, service]
--host <host>Stado host for service surfaces
--workspace <workspace>The workspace of canonical checkouts this operation reads and builds from; default WISENT_WORKSPACE, else ~/Documents/CodingProjects/Wisent
--fetchFetch canonical origins before checking source readiness
--clone-missingClone a product's source from its GitHub origin into the workspace when the workspace holds no checkout of it, instead of holding the product
--dry-runReport decisions without fetching, building or installing
--jsonPrint each product's final decision and error

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.