stable_pretraining.registry

Filesystem-backed run registry. Every training run writes a small sidecar.json next to its CSV logs; a separate scanner indexes those sidecars into a SQLite cache for fast queries. No SQLite server, no network — just files under cache_dir.

Logger

The Lightning logger that writes the sidecar (auto-injected by Manager).

RegistryLogger(run_dir, run_id, *[, tags, ...])

CSV logger with a filesystem-indexable sidecar.

In addition to the standard log_metrics / log_hyperparams Lightning hooks, RegistryLogger exposes log_image(key, images, step=…, caption=…) and log_video(key, videos, step=…, caption=…, fps=…). These match WandbLogger’s signatures, so existing callbacks that call trainer.logger.log_image(...) start writing to disk without any code change. Files land under {run_dir}/media/<safe_tag>/ and each event is appended to {run_dir}/media.jsonl for indexing.

Query API

Read-only interface to the indexed runs — used by spt registry and any custom analysis scripts.

Registry(store)	Read-only query interface over the registry cache.
RunRecord(run_id, status, created_at, ...)	Immutable view of a single training run, hydrated from the cache.

open_registry([db_path, cache_dir, scan, ...])

Open the registry for querying.