Skip to content

feat(server): default sync interval to 5m and document evented refresh#1320

Open
jonnii wants to merge 1 commit into
jonnii/20260623030002/add-manual-sync-endpoint-for-on-demand-refreshfrom
jonnii/20260623030405/default-sync-interval-to-5m-and-document-evented
Open

feat(server): default sync interval to 5m and document evented refresh#1320
jonnii wants to merge 1 commit into
jonnii/20260623030002/add-manual-sync-endpoint-for-on-demand-refreshfrom
jonnii/20260623030405/default-sync-interval-to-5m-and-document-evented

Conversation

@jonnii

@jonnii jonnii commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

The sync loop was opt-in: STACKIT_SYNC_INTERVAL unset meant 0, which disabled it
entirely, so a server with no explicit interval never pulled remote changes. With
webhooks now able to drive immediate refreshes, the interval becomes the
backstop — so it should exist by default.

  • envSyncInterval defaults to 5m when STACKIT_SYNC_INTERVAL is unset; "0" still
    explicitly disables, and an unparseable value falls back to the default rather
    than silently disabling the loop.
  • docs/deploy.md: explain the three refresh triggers (interval, webhook, manual),
    document webhook setup (payload URL, secret, push event), the manual-sync
    endpoint, and how local servers stay current without webhooks (fsnotify
    watcher + manual sync). Calls out that GitHub sends no push event for
    refs/stackit/metadata/*, so the interval loop must stay on as a backstop.

Stack

Auto-generated by Stackit

The sync loop was opt-in: STACKIT_SYNC_INTERVAL unset meant 0, which disabled it
entirely, so a server with no explicit interval never pulled remote changes. With
webhooks now able to drive immediate refreshes, the interval becomes the
backstop — so it should exist by default.

- envSyncInterval defaults to 5m when STACKIT_SYNC_INTERVAL is unset; "0" still
  explicitly disables, and an unparseable value falls back to the default rather
  than silently disabling the loop.
- docs/deploy.md: explain the three refresh triggers (interval, webhook, manual),
  document webhook setup (payload URL, secret, push event), the manual-sync
  endpoint, and how local servers stay current without webhooks (fsnotify
  watcher + manual sync). Calls out that GitHub sends no push event for
  refs/stackit/metadata/*, so the interval loop must stay on as a backstop.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant