Documentation
¶
Overview ¶
Package report renders a human-readable projection of a committed query snapshot.
Index ¶
- func ReadContent(ctx context.Context, queries *query.Service, run ports.PublicationRun, ...) (query.ContentChunk, error)
- type CommittedReader
- type Report
- func (report Report) Bytes() []byte
- func (report Report) Epoch() uint64
- func (report Report) EpochPath() ports.SafeRelativePath
- func (report Report) FinalPath() ports.SafeRelativePath
- func (report Report) FinalSHA256() string
- func (report Report) LineageEdgePath() ports.SafeRelativePath
- func (report Report) LineageEdgeSHA256() string
- func (report Report) ManifestPath() ports.SafeRelativePath
- func (report Report) ManifestSHA256() string
- func (report Report) ReviewID() domain.ReviewID
- func (report Report) RunID() domain.RunID
- func (report Report) SessionID() domain.SessionID
- func (report Report) TargetSHA256() string
- type Service
- type SnapshotOpener
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ReadContent ¶ added in v0.1.24
func ReadContent(ctx context.Context, queries *query.Service, run ports.PublicationRun, binding domain.ProjectBinding, role string, continuation query.ContentContinuation) (query.ContentChunk, error)
ReadContent reuses rendering against a query-owned, receipt-bound snapshot.
Types ¶
type CommittedReader ¶
type CommittedReader interface {
ReadCommitted(context.Context, ports.PublicationRun) (query.CommittedReview, error)
RenderExcerptAt(context.Context, ports.PublicationRun, string, string, int) ([]byte, error)
}
CommittedReader is the report-owned boundary for verified committed review data and fresh current-evidence excerpts.
type Report ¶
type Report struct {
// contains filtered or unexported fields
}
Report is an immutable derived report and the committed identities from which it was rendered.
func (Report) EpochPath ¶
func (report Report) EpochPath() ports.SafeRelativePath
EpochPath returns the committed source publication epoch record path.
func (Report) FinalPath ¶
func (report Report) FinalPath() ports.SafeRelativePath
FinalPath returns the committed source final artifact path.
func (Report) FinalSHA256 ¶
FinalSHA256 returns the committed source final artifact digest.
func (Report) LineageEdgePath ¶
func (report Report) LineageEdgePath() ports.SafeRelativePath
LineageEdgePath returns the committed source lineage edge path.
func (Report) LineageEdgeSHA256 ¶
LineageEdgeSHA256 returns the committed source lineage edge digest.
func (Report) ManifestPath ¶
func (report Report) ManifestPath() ports.SafeRelativePath
ManifestPath returns the committed source manifest path.
func (Report) ManifestSHA256 ¶
ManifestSHA256 returns the committed source manifest digest.
func (Report) TargetSHA256 ¶
TargetSHA256 returns the committed source target digest.
type Service ¶
type Service struct {
// contains filtered or unexported fields
}
Service renders a deterministic report from one P2-committed query snapshot.
func NewService ¶
func NewService(opener SnapshotOpener) (*Service, error)
NewService creates a report renderer. The query boundary is required so the renderer cannot consult publication artifacts or targets on its own.
type SnapshotOpener ¶ added in v0.1.26
type SnapshotOpener interface {
WithVerifiedSnapshot(context.Context, ports.PublicationRun, func(context.Context, query.ContentReader) error) error
}
SnapshotOpener runs one render inside a query-owned, per-call verified snapshot: the committed snapshot, its whole-support verification and the retirement walk complete before the render runs, and every consumed publication is confirmed before the render returns. *query.Service satisfies it.
Source Files