Bondstone.Persistence.EntityFrameworkCore.Postgres 1.1.0

Bondstone

Bondstone is a .NET library for durable module boundaries, durable command sending, EF Core backed inbox/outbox persistence, and transport adapters.

Stable docs describe the current package, architecture, setup, repository, sample, and verification contracts. ADRs preserve the decision trail. GitHub Issues and GitHub Projects track backlog work.

Packages

Current package IDs, dependency direction, target framework, versioning, and publishing policy are recorded in docs/packaging.md.

Getting Started

Start with docs/setup.md for the normal host setup path. It shows how to compose modules, PostgreSQL persistence, a direct transport adapter, and the hosted outbox worker through AddBondstone.

Use the package READMEs under src/ as quick package-purpose guides. Use architecture docs when you need the durable behavior contract behind a package.

Repository Map

• docs/README.md is the durable documentation index.
• docs/adr/README.md explains the ADR workflow.
• docs/architecture/README.md records runtime positioning.
• docs/setup.md is the single user-facing setup example.
• docs/packaging.md records package and release policy.
• docs/repository.md records repository layout and tooling.
• docs/samples.md records sample direction.
• docs/testing.md records test categories and verification.
• src/ contains package projects.
• tests/ contains package and integration-boundary test projects.
• samples/ is reserved for sample applications.

Verification

Run pnpm install, then pnpm check.

pnpm verify is kept as an alias for pnpm check.

The default quality gate runs formatting, restore, build, fast test categories, and pack. Infrastructure-backed integration tests are intentionally separate.

Pull request titles must follow Conventional Commits because squash merges use the PR title as the release-relevant commit message.

Publishing

Release Please manages the central package version in Directory.Build.props, the changelog, release pull request, tag, and GitHub release. NuGet publication runs from the Publish NuGet workflow when a release is published, or manually through workflow dispatch for the selected ref.

Required repository setup:

• RELEASE_PLEASE_TOKEN so Release Please-created releases can trigger the separate publish workflow.
• NUGET_USER repository variable with the nuget.org username or organization profile name used by trusted publishing.
• NuGet trusted publishing policy for .github/workflows/publish-nuget.yml.

Current Direction

Bondstone is built gradually as a durable module-boundary library. Do not bulk-copy implementation code from the historical template repository or preserve compatibility with it as a design constraint. Current implementation work should follow the stable docs, check ADR requirements before broad technical decisions, and keep package boundaries, public API shape, tests, and docs aligned.