syncguidance

func AppendGuidance ¶

func AppendGuidance(message, project string, err error) string

AppendGuidance preserves the original message and appends deterministic, non-mutating recovery instructions for known repairable or policy failures.

func Guidance ¶

func Guidance(project string) string

func IsPolicyFailure ¶

func IsPolicyFailure(err error) bool

IsPolicyFailure reports whether an error represents a server policy denial. It intentionally remains separate from locally repairable sync failures.

func IsRepairableCloudSyncError ¶

func IsRepairableCloudSyncError(err error) bool

IsRepairableCloudSyncError returns true for known cloud sync/upsert/canonicalization failures that can be diagnosed by the explicit cloud upgrade doctor/repair flow. It never mutates local or remote state.

func PolicyGuidance ¶

func PolicyGuidance(project string) string

PolicyGuidance explains the server-side checks needed after a policy denial.

func ProjectFromError ¶

func ProjectFromError(err error) string

ProjectFromError extracts the grouped autosync project from wrapped errors such as transport push project "proj-a". It returns an empty string when unknown.

func ProjectFromTargetKey ¶

func ProjectFromTargetKey(targetKey string) string

ProjectFromTargetKey derives the project suffix from cloud:<project> target keys.