Claude 1890958ff2 refactor(sync): make SSH sync handler lazy-initialized ...

The module-level SSHSyncHandler() singleton ran filesystem side effects
(mkdir on SYNC_SSH_KEYS_PATH) at import time, which meant even default
installs with push-pull sync disabled would touch /romm/sync — and the
previous tolerate-and-warn fallback could leave users wondering why
sync silently does nothing.

Replace the eager singleton with a functools.cache'd factory. The
handler is now constructed on first use, so:

  - Default-install users (ENABLE_SYNC_PUSH_PULL=false, no manual sync
    triggered) never touch /romm/sync.
  - Users opting in get a clear, actionable RuntimeError pointing at
    the unwritable path and the env var to override, at the call site
    rather than buried in a startup stack trace.

Also document in env.template that enabling either sync mode requires
a writable volume at $ROMM_BASE_PATH/sync.

2026-05-24 14:49:53 +00:00

..

__init__.py

bot attempt at save sync

2026-03-14 22:13:38 -04:00

comparison.py

bot attempt at save sync

2026-03-14 22:13:38 -04:00

ssh_handler.py

refactor(sync): make SSH sync handler lazy-initialized

2026-05-24 14:49:53 +00:00