beads/test
Steve Yegge 227d0f5f46
feat(storage): public backend contract + conformance suite for out-of-tree backends (bd-h3dib.2) (#5321)
* bd-h3dib.2: move storage conformance suite to public backend/conformance

Relocate internal/storage/conformance to backend/conformance so external
Go modules can import and run the suite against out-of-tree storage
backends (the conformance-gated external-backend path promised on #4415).
Pure move: package name, entry points, and assertions are unchanged; the
seven in-tree test importers are rewritten and path references in doc
comments updated. The package doc now states the external usage and the
experimental stability terms.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* bd-h3dib.2: add public backend package exporting the storage backend contract

The alias facade an external Go module implements a storage backend
against: the engine interface (storage.DoltStorage) and its capability
sub-interfaces, every named type reachable from their method signatures
(measured by type-closure walk: 24 storage types, 36 domain types, plus
the already-public issueops request/response surface), the sentinel
errors and message fragments the contract requires by identity, the
Iter/SliceIter kit, and thin wrappers over the internal/storage/backends
registry. Aliases only - the internal packages remain the source of
truth and no behavior changes.

TestPublicSurfaceComplete is the drift guard: it reflects over the
public contract's type closure and fails if any reachable internal type
lacks an alias here, so a future signature change cannot silently
re-lock the external-backend door. It already caught two types a static
signature scan missed (IssueDetails via issueops.Reader's page results,
PersistenceMode via wisp fields).

Follows the established public-facade convention of the root beads
package and issueops. Stability: documented EXPERIMENTAL.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* bd-h3dib.2: changelog for the public external-backend surface

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* bd-h3dib.2: point the root beads package doc at the backend implementer surface

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-08-03 16:03:11 -07:00
..
conformance feat(storage): public backend contract + conformance suite for out-of-tree backends (bd-h3dib.2) (#5321) 2026-08-03 16:03:11 -07:00
docsync docs(recovery): restore RECOVERY.md as a forwarding stub for shipped v1.1.0 links 2026-07-17 18:14:00 -07:00