Skip to content

Experiment: pg-fs persistence probe (local only) - #15

Draft
nkarpov wants to merge 1 commit into
mainfrom
spike/pgfs-persistence-probe
Draft

nkarpov wants to merge 1 commit into
mainfrom
spike/pgfs-persistence-probe

Conversation

@nkarpov

@nkarpov nkarpov commented Feb 27, 2026

Copy link
Copy Markdown
Owner

Summary

Experimental spike to evaluate PostgreSQL/Lakebase-backed persistence via pg-fs.

This PR intentionally adds a local probe only (no runtime wiring yet) so we can keep a reference implementation and benchmark path in the repo.

Included

  • scripts/pgfs-probe.mjs
    • commands: push, pull, list, bench
    • env-configured include/exclude globs
    • manifest-driven restore model
  • npm run pgfs:probe -- <command>
  • README section for local usage
  • .gitignore update for local env files (.env, .env.local)

Safety / hygiene

  • No credentials committed
  • No runtime session data committed
  • Connection string is expected only via local env (PGFS_DATABASE_URL)

Notes from spike

  • pg-fs was not fully plug-and-play in our environment (schema bootstrap/index behavior required manual investigation during testing).
  • This is not production-ready persistence yet; it is an experiment artifact for iteration.

Add a local-only pg-fs probe script and npm command to evaluate PostgreSQL-backed state persistence without shipping secrets or runtime data.

Includes bench/list/push/pull workflows, docs, and environment-variable based configuration for credentials.
@nkarpov nkarpov added the experiment Experimental / spike work label Feb 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

experiment Experimental / spike work

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant