Skip to main content
← Back to list
01Issue
FeatureOpenSwamp CLI
AssigneesNone

Relationships

#443 Default hydrationStrategy to lazy after soak period

Opened by stack72 · 5/25/2026

Context

Lazy hydration (#440) has shipped as opt-in via --hydration-strategy lazy on swamp datastore setup extension. It downloads only metadata files on initial setup and hydrates raw content on demand. Proven against real GCS at scale (64% faster setup, 98% less disk on 1000-file repos).

Proposal

After a soak period with opt-in users and no reported issues, change the default hydrationStrategy from "full" to "lazy".

This is a one-line change in src/domain/datastore/datastore_config.ts — wherever the default is resolved. The --hydration-strategy flag remains available for users who want to explicitly choose "full".

Prerequisites

  • No bug reports from opt-in lazy hydration users
  • UAT datastore suite passes with lazy as default
  • Confirm no code paths read raw files without going through getContent() (which has the hydrate hook)
  • Confirm all extensions in the registry that implement createSyncService also implement hydrateFile

Risk

Low — lazy hydration has been tested end-to-end against MinIO and real GCS. The transparent hydration hook covers data get, data list, data versions, model runs (via scoped pull), and workflow runs. The only risk is an undiscovered code path that reads raw files directly from disk without going through the hooked getContent().

Users who experience issues can pass --hydration-strategy full to restore today's behavior.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED

Open

5/25/2026, 10:07:50 PM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.