Expand description
EngineBackend implementation backed by Postgres.
RFC-v0.7 Wave 0 — scaffold. This crate lands the
PostgresBackend struct + the impl EngineBackend block with
every method stubbed to return EngineError::Unavailable.
Subsequent waves fill in bodies:
- Wave 1: cross-cutting error/helpers.
- Wave 2: describe / list / resolve (read surface).
- Wave 3: schema migrations (replaces the Wave 0 placeholder).
- Wave 4: LISTEN/NOTIFY wiring + stream reads/tails.
- Wave 5-7: hot-path write methods.
- Wave 8: ff-server wire-up + dual-backend running.
The trait stays object-safe; consumers can hold
Arc<dyn EngineBackend>. No ferriskey dep — this crate’s
transport is sqlx.
Re-exports§
pub use completion::PostgresCompletionStream;pub use completion::COMPLETION_CHANNEL;pub use error::map_sqlx_error;pub use error::PostgresTransportError;pub use listener::StreamNotifier;pub use migrate::apply_migrations;pub use migrate::MigrationError;pub use scanner_supervisor::PostgresScannerConfig;pub use scanner_supervisor::PostgresScannerHandle;pub use version::check_schema_version;
Modules§
- attempt
- Attempt trait-method family — Postgres implementation.
- budget
- Budget family — Postgres impl.
- completion
CompletionBackendimplementation for Postgres (Wave 4h / Q1).- dispatch
- Post-completion dependency-resolution cascade (Wave 5a).
- error
sqlx::Error→EngineErrormapping for the Postgres backend.- exec_
core - exec_core trait-method family — Postgres impls.
- flow
- Postgres flow-family
EngineBackendimplementations (Wave 4c). - flow_
staging - Postgres flow-staging inherent methods (Wave 4i).
- handle_
codec - Postgres-side thin wrapper over
ff_core::handle_codec. - listener
- Shared LISTEN connection + in-memory stream notifier.
- migrate
- Schema-migration application.
- operator
- RFC-020 Wave 9 Spine-A pt.1 — operator-control mutating methods
(
cancel_execution+revoke_lease). - pool
- PgPool construction helper.
- reconcilers
- Postgres-backend scanner reconcilers (RFC-v0.7 Wave 6).
- scanner_
supervisor - Postgres scanner supervisor (RFC-017 Wave 8 Stage E3).
- scheduler
- Admission-pipeline for the Postgres backend (RFC-v0.7 Wave 5b).
- signal
- Signal delivery + HMAC secret rotation for the Postgres backend.
- stream
- Stream-family trait methods on the Postgres backend (RFC-015).
- suspend
- Suspend + resume plumbing for the Postgres backend.
- suspend_
ops - Suspend / deliver_signal / claim_resumed / observe_signals SQL bodies.
- version
- Boot-time schema-version check.
Structs§
- Postgres
Backend - Postgres
Connection - Postgres-specific connection parameters (RFC-v0.7 Wave 0).