@paraharness/postgres

Variables

Variable	Description
postgres	Frozen postgres builder namespace exported by @paraharness/postgres.
POSTGRES_DDL_STATEMENTS	Ordered PostgreSQL DDL statements initializing the ledger, topology CoW overlay, and lesson store tables.
POSTGRES_IDENTIFIER_REGEX	Strict regular expression validating SQL table and column identifiers (^[A-Za-z_][A-Za-z0-9_]*$).
postgresExecutors	Default frozen RuntimeExecutorRegistrySlice for @paraharness/postgres.

Functions

Function	Description
computeNormalizedRelevance	Computes normalized text relevance $R(L, Q) \in [0, 1]$ between a single lesson directive and queryText via MiniSearch.
computeNormalizedRelevanceScores	Computes normalized BM25 + fuzzy/prefix relevance scores $R(L, Q) \in [0, 1]$ across candidates using MiniSearch.
createCompactionConfigBuilder	Creates an immutable CompactionConfigBuilder instance for PostgreSQL ledger wire-frame pruning policies.
createPostgresExecutors	Creates a RuntimeExecutorRegistrySlice registering all @paraharness/postgres storage and source executors.
createPostgresGlobalRulesBuilder	Creates a pure, side-effect-free PostgresGlobalRulesBuilder for postgres.globalRules(uri, options).
createPostgresLedgerBuilder	Creates a pure, side-effect-free PostgresLedgerBuilder for postgres.ledger(uri).
createPostgresLessonsBuilder	Creates a pure, side-effect-free PostgresLessonsBuilder for postgres.lessonStore(uri).
createPostgresTopologyBuilder	Creates a pure, side-effect-free PostgresTopologyBuilder for postgres.topologyStore(uri).
executePostgresGlobalRulesSource	Executes a PostgresRulesSourceNode (type: 'postgres:global-rules') to load ordered global rules.

Classes

Class	Description
PostgresLedgerStore	PostgreSQL implementation of the @paraharness/core LedgerStore runtime port.
PostgresLessonStore	PostgreSQL implementation of the @paraharness/core LessonStore runtime port.
PostgresTopologyStore	PostgreSQL implementation of the @paraharness/core TopologyStore runtime port.

Interfaces

Interface	Description
CompactionConfigBuilder	Fluent configurator for PostgreSQL ledger wire-frame compaction policies (.compactWhen($c => ...)).
CompactionSignalTriggerOptions	Options for configuring a signal-correlated ledger compaction trigger via CompactionConfigBuilder.onSignal.
CompactionTerminalExitOptions	Options for configuring a terminal exit state compaction trigger via CompactionConfigBuilder.onTerminalExit.
PostgresGlobalRulesBuilder	Fluent builder for a passive PostgresRulesSourceNode (postgres:global-rules) AST node.
PostgresGlobalRulesOptions	Options passed to postgres.globalRules(uri, options).
PostgresLedgerBuilder	Fluent builder for a passive PostgresLedgerNode (postgres:ledger) AST node.
PostgresLedgerNode	Passive AST node configuring a PostgreSQL ledger store (postgres.ledger).
PostgresLessonsBuilder	Fluent builder for a passive PostgresLessonsNode (postgres:lessons) AST node.
PostgresLessonsNode	Passive AST node configuring a PostgreSQL lesson store (postgres.lessonStore).
PostgresNamespace	Public postgres adapter builder namespace contract (@paraharness/postgres).
PostgresPinnedClient	Dedicated PostgreSQL connection checked out from a connection pool (pg.PoolClient or test adapter) for the duration of a single BEGIN / COMMIT / ROLLBACK transaction.
PostgresPoolFactory	Factory contract resolving a PostgreSQL connection URI into an active PostgresQueryClient.
PostgresQueryClient	Minimal asynchronous PostgreSQL query client contract used by @paraharness/postgres stores and executors.
PostgresQueryResult	Normalized query result returned by a PostgresQueryClient.query() invocation.
PostgresRulesSourceNode	Passive AST node loading global rules from a PostgreSQL table (postgres.globalRules).
PostgresTopologyBuilder	Fluent builder for a passive PostgresTopologyNode (postgres:topology) AST node.
PostgresTopologyNode	Passive AST node configuring a PostgreSQL topology store (postgres.topologyStore).