Troubleshooting
Diagnose transport failures, stalled outboxes, unsafe paths, and verification differences.
Start with:
An unreachable hub keeps queued work durable and retries later. Do not delete local state to clear an outbox. Fix authentication, reachability, permissions, or the configured remote command instead.
If verification reports a difference, stop the mutating service, retain journals and recovery data, and inspect the first divergent path. After correcting the cause, run codefoldersync verify --full again before resuming.
Unsafe traversal, ambiguous local state, corrupt immutable content, or invalid Git metadata deliberately fail closed. Treat the failure as evidence to investigate, not a guard to bypass.