Recipe — let an agent publish on your behalf

spec0 doctor --output=json | jq -e '.ok'

# 1. Make sure the spec is well-formed enough to publish.
spec0 lint openapi.yaml --min-score 80 --format json || {
  echo "Lint below threshold. Surface the errors to the user." >&2
  exit 7
}

# 2. If the API already exists, skip the publish when the spec is unchanged.
API_NAME=$(yq '.info.title' openapi.yaml | tr '[:upper:] ' '[:lower:]-')

if spec0 api show "$API_NAME" --output=json >/dev/null 2>&1; then
  if ! spec0 sync-status "$API_NAME" --output=json | jq -e '.needsPublish' >/dev/null; then
    echo "No change since last publish — nothing to do."
    exit 0
  fi
fi

# 3. Publish with auto-computed semver so breaking changes get a major bump.
spec0 publish openapi.yaml --semver --output=json > publish-result.json

# 4. Close the loop: confirm the new version landed.
VERSION=$(jq -r .version publish-result.json)
spec0 log "$API_NAME" --output=json \
  | jq -e --arg v "$VERSION" '.[0].version == $v' >/dev/null