pipelinesvc

package
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: Apache-2.0 Imports: 70 Imported by: 0

Documentation

Index

Constants

View Source
const (
	ReconcileFromGitSkippedReasonFilteredOut = "filtered_out"
)

Variables

View Source
var ErrODCSContractReference = xerror.New(xerror.KindInvalidInput, "PIPELINE_ODCS_REFERENCE_INVALID", "pipeline ODCS contract reference cannot be resolved")
View Source
var ErrPipelineAlreadyExists = xerror.AlreadyExists(xerror.Pipeline)
View Source
var ErrPipelineDeploymentConflict = xerror.New(
	xerror.KindAlreadyExists,
	"PIPELINE_DEPLOYMENT_CONFLICT",
	"pipeline deployment conflict",
)
View Source
var ErrPipelineDeploymentNotFound = xerror.NotFound(xerror.PipelineDeployment)
View Source
var ErrPipelineDraftConflict = xerror.New(
	xerror.KindAlreadyExists,
	"PIPELINE_DRAFT_CONFLICT",
	"pipeline draft version conflict",
)
View Source
var ErrPipelineDraftNotFound = xerror.NotFound(xerror.PipelineDraft)
View Source
var ErrPipelineExecutionFailed = xerror.ExecutionFailed()
View Source
var ErrPipelineExecutionNotStarted = xerror.New(xerror.KindInternal, "PIPELINE_EXECUTION_NOT_STARTED", "pipeline execution not started")

ErrPipelineExecutionNotStarted marks failures known to precede connector execution.

View Source
var ErrPipelineGitSourceRequired = xerror.New(
	xerror.KindInvalidInput,
	"PIPELINE_GIT_SOURCE_REQUIRED",
	"pipeline git source is required",
)
View Source
var ErrPipelineNotFound = xerror.NotFound(xerror.Pipeline)
View Source
var ErrPipelineProposalAuthorityDenied = jobs.ErrPipelineProposalAuthorityDenied
View Source
var ErrPipelineReconcileSourceChanged = xerror.New(
	xerror.KindAlreadyExists,
	"PIPELINE_RECONCILE_SOURCE_CHANGED",
	"Git source changed since preview; preview again before applying",
)
View Source
var ErrPipelineRunNotFound = xerror.NotFound(xerror.PipelineRun)
View Source
var ErrPipelineValidationPrincipalRequired = xerror.New(
	xerror.KindUnauthorized,
	"PIPELINE_VALIDATION_PRINCIPAL_REQUIRED",
	"pipeline validation history requires an authenticated principal",
)
View Source
var ErrPipelineValidationResultNotFound = xerror.NotFound(xerror.PipelineValidationResult)
View Source
var ErrPipelineVersionNotFound = xerror.NotFound(xerror.PipelineVersion)
View Source
var ErrProjectEnvironmentNotFound = xerror.NotFound(xerror.ProjectEnvironment)
View Source
var ErrProofReceiptLinkMismatch = xerror.New(
	xerror.KindInvalidInput,
	"PROOF_RECEIPT_LINK_MISMATCH",
	"proof receipt does not match the exact deployment target",
)
View Source
var ErrRetryElapsed = xerror.New(xerror.KindInvalidInput, "PIPELINE_RETRY_ELAPSED", "retry elapsed-time cap exceeded")

ErrRetryElapsed marks a retry refused before runtime starts.

Functions

func CheckExecutionStartDeadline

func CheckExecutionStartDeadline(ctx context.Context) error

CheckExecutionStartDeadline permits starting exactly at the captured deadline.

func InspectConnectedRuns

func InspectConnectedRuns(ctx context.Context, selected slug.Slug, read func(slug.Slug) (*model.PipelineRunCompletion, error), visible func(model.PipelineCompletionDecision) (bool, error)) (*model.PipelineRunConnected, error)

InspectConnectedRuns bounds decision visibility checks before traversing authorized evidence. Each read is a consistent snapshot; outcomes may advance between reads.

func NewSinkEffectLedger

NewSinkEffectLedger creates the durable ledger that guards production sink dispatch.

func PipelineValidationResultSourceStrings

func PipelineValidationResultSourceStrings() []string

PipelineValidationResultSourceStrings returns a slice of all String values of the enum

func ProofLifecycleLinkStatus

func ProofLifecycleLinkStatus(link *proofreceipts.LifecycleLink, currentSpecHash, deploymentIdentifier string, now time.Time) string

func WithExecutionStartDeadline

func WithExecutionStartDeadline(ctx context.Context, at time.Time, clk clock.Clock) context.Context

WithExecutionStartDeadline limits when runtime may start, including admission wait.

Types

type CompletionAuthorityChecker

type CompletionAuthorityChecker interface {
	CheckCompletionSnapshot(context.Context, slug.Slug, slug.Slug, slug.Slug, int) (*model.PipelineCompletionSnapshot, error)
}

type CreationProposal

type CreationProposal struct {
	Slug         slug.Slug
	ProjectSlug  slug.Slug
	PipelineSlug slug.Slug
	MemberSlug   slug.Slug
	SourcePath   string
	SpecHash     string
	Spec         *pipelinespec.Pipeline
	Status       string
	FailureCode  string
	Proposal     *pipelinegit.ProposalResult
}

CreationProposal is pending authoring state, never a deployable canonical pipeline.

type CreationProposalPage

type CreationProposalPage struct {
	Items   []*CreationProposal
	HasMore bool
}

type CreationService

type CreationService struct {
	// contains filtered or unexported fields
}

func NewCreationService

func NewCreationService(txm postgres.TransactionManager, repo creationRepository, projects creationProjectService, store creationPipelineStore, auth authorization.Service, producer workerproducer.PipelineGitProducer, events workerproducer.EventProducer) (*CreationService, error)

func (*CreationService) AuthorizeProposalPublish

func (s *CreationService) AuthorizeProposalPublish(ctx context.Context, args jobs.PipelineGitPublishProposalArgs) error

func (*CreationService) CompleteProposal

func (s *CreationService) CompleteProposal(ctx context.Context, completed pipelinegit.ProposalCompletion) error

func (*CreationService) Create

func (s *CreationService) Create(ctx context.Context, org, project, member slug.Slug, actor model.EventActor, spec *pipelinespec.Pipeline) (*CreationProposal, error)

func (*CreationService) FailProposal

func (s *CreationService) FailProposal(ctx context.Context, failed pipelinegit.ProposalFailure) error

func (*CreationService) Get

func (s *CreationService) Get(ctx context.Context, org, project, creation slug.Slug) (*CreationProposal, error)

func (*CreationService) List

func (s *CreationService) List(ctx context.Context, org, project, after slug.Slug, limit int) (*CreationProposalPage, error)

type DeployPipelineRequest

type DeployPipelineRequest struct {
	ResolutionInputs                 map[string]odcs.ResolutionValue
	ExpectedRevision                 *int64
	CompiledPlanDigest               *string
	ResolutionDigest                 *string
	SpecHash                         string
	ExpectedCurrentSpecHash          *string
	SourceEnvironmentSlug            *slug.Slug
	ProtectedEnvironmentConfirmation *slug.Slug
	ProofReceiptSlug                 *slug.Slug
}

DeployPipelineRequest points an environment at an existing immutable version.

type DriftImpactReport

type DriftImpactReport struct {
	Slug           slug.Slug
	ReportType     pipelinedrift.ReportType
	Status         pipelinedrift.ReportStatus
	Severity       pipelinedrift.ReportSeverity
	Summary        string
	Changes        []pipelinedrift.Change
	Impacts        []pipelinedrift.Impact
	ProjectSlug    *slug.Slug
	PipelineSlug   *slug.Slug
	DataSourceSlug *slug.Slug
	CreatedAt      time.Time
	SupersededAt   *time.Time
}

type DriftImpactReportFilters

type DriftImpactReportFilters struct {
	ProjectSlug    *slug.Slug
	PipelineSlug   *slug.Slug
	DataSourceSlug *slug.Slug
	Status         *pipelinedrift.ReportStatus
	Severity       *pipelinedrift.ReportSeverity
	Limit          int32
}

type GitDraftPublishRequest

type GitDraftPublishRequest struct {
	ProjectSlug      slug.Slug
	PipelineSlug     slug.Slug
	MemberSlug       slug.Slug
	BaseRef          *string
	BaseCommitSHA    *string
	ExpectedHeadSHA  *string
	BranchName       string
	SourcePath       string
	Content          []byte
	CommitMessage    string
	ProposalTitle    string
	ProposalBody     string
	DraftSpecHash    string
	PublishAttemptID string
	Authority        model.PipelineProposalAuthority
}

GitDraftPublishRequest is the queued outbound git write for a Git-authored draft publish.

type GitProposalMetadata

type GitProposalMetadata struct {
	Provider         string
	ProposalID       string
	ProposalURL      string
	ProposalState    string
	BranchName       string
	BranchHeadSHA    string
	DraftSpecHash    string
	PublishAttemptID string
}

GitProposalMetadata is safe provider proposal metadata returned by worker execution.

type GitProposalRefreshRequest

type GitProposalRefreshRequest struct {
	ProjectSlug      slug.Slug
	PipelineSlug     slug.Slug
	MemberSlug       slug.Slug
	ProposalID       string
	RefreshAttemptID string
}

GitProposalRefreshRequest identifies one exact provider proposal for an idempotent state refresh.

type PipelineDeploymentDetail

type PipelineDeploymentDetail struct {
	Revision                     int64
	CurrentResolutionDigest      *string
	PreviousResolutionDigest     *string
	ProjectSlug                  slug.Slug
	EnvironmentSlug              slug.Slug
	PipelineSlug                 slug.Slug
	CurrentVersionID             int64
	CurrentVersionSpecHash       string
	CurrentVersionShortSpecHash  string
	PreviousVersionID            *int64
	PreviousVersionSpecHash      *string
	PreviousVersionShortSpecHash *string
	DeployedByActorType          string
	DeployedByActorSlug          *string
	DeployedAt                   time.Time
	UpdatedAt                    time.Time
	DataSourceRefSync            *datasourcerefssvc.PipelineDataSourceRefSyncResult
	ProofLink                    *ProofLifecycleLink
}

PipelineDeploymentDetail contains the current deployed version for one environment.

type PipelineDetail

type PipelineDetail struct {
	Summary *PipelineSummary
	Spec    *pipelinespec.Pipeline
	Draft   *PipelineDraftDetail
}

PipelineDetail contains persisted metadata plus the parsed pipeline spec.

type PipelineDraftConflictError

type PipelineDraftConflictError struct {
	PipelineSlug          slug.Slug
	ExpectedVersionID     *int64
	CurrentVersionID      *int64
	DraftBasedOnVersionID *int64
	ExpectedSpecHash      *string
	CurrentSpecHash       *string
	DraftBasedOnSpecHash  *string
	DraftPreserved        bool
	CanOverwrite          bool
}

PipelineDraftConflictError carries structured version mismatch details.

func (*PipelineDraftConflictError) Error

func (*PipelineDraftConflictError) Unwrap

func (e *PipelineDraftConflictError) Unwrap() error

type PipelineDraftDetail

type PipelineDraftDetail struct {
	PipelineSlug     slug.Slug
	InitiatingMember slug.Slug

	BasedOnSpecHash       *string
	CreatedAt             time.Time
	UpdatedAt             time.Time
	Spec                  *pipelinespec.Pipeline
	DraftBasedOnVersionID *int64
	CurrentVersionID      *int64
	DraftState            string
	DraftSpecHash         string
	Repository            string
	ProposalSupported     bool
	BaseRef               *string
	BaseCommitSHA         *string
	BranchName            *string
	BranchHeadSHA         *string
	ProposalProvider      *string
	ProposalID            *string
	ProposalURL           *string
	ProposalState         *string
	ProposalIsStale       bool
	LastProposedDraftHash *string
	QueuedAt              *time.Time
	ProposalUpdatedAt     *time.Time
	FailedAt              *time.Time
	FailureCode           *string
	FailureMessage        *string
	PublicationMode       *string
	ProviderActor         *string
	AuthoritySource       *string
	// contains filtered or unexported fields
}

PipelineDraftDetail contains mutable draft spec and metadata.

type PipelineRunDetail

type PipelineRunDetail struct {
	Composition            *RunCompositionInspection
	Metadata               PipelineRunMetadata
	Timeline               pipelinerun.RunTimeline
	IncrementalDiagnostics pipelinerun.IncrementalRunDiagnostics
	ProofLink              *ProofLifecycleLink
}

PipelineRunDetail includes metadata plus diagnostics payload for a run.

type PipelineRunMetadata

type PipelineRunMetadata struct {
	PipelineVersionID       int64
	PipelineVersionSpecHash string
	EnvironmentSlug         string
	PipelineSlug            string
	RunSlug                 string
	Source                  pipelinerun.RunSourceSummary
	RequestID               *string
	Status                  string
	DurationMs              int64
	StepCount               int32
	StepSlug                string
	ErrorSummary            *string
	FailureKind             *string
	StartedAt               time.Time
	EndedAt                 *time.Time
	ReplayOfRunSlug         *string
	ReplayFromStep          *string
	Incremental             pipelinerun.IncrementalRunSummary
	CreatedAt               time.Time
}

PipelineRunMetadata contains persisted run summary fields used by operators.

type PipelineStore

type PipelineStore interface {
	ResolvePipelineContracts(context.Context, slug.Slug, slug.Slug, *pipelinespec.Pipeline) (*pipelinespec.Pipeline, []model.PinnedODCSPort, error)
	ResolveProposalAuthority(
		ctx context.Context,
		orgSlug, projectSlug slug.Slug,
	) (model.PipelineProposalAuthority, error)

	// FindSpec returns the full canonical spec record including Git provenance.
	// Returns ErrPipelineNotFound if no spec exists.
	FindSpec(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
	) (*pipelinesrepo.PipelineSpec, error)

	// FindSpecForUpdate returns the full canonical spec record locked in the current unit of work.
	// Returns ErrPipelineNotFound if no spec exists.
	FindSpecForUpdate(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
	) (*pipelinesrepo.PipelineSpec, error)

	// Get returns the parsed pipeline spec from the canonical DB store.
	// Returns ErrPipelineNotFound if no spec exists.
	Get(ctx context.Context, orgSlug, projectSlug, pipelineSlug slug.Slug) (*pipelinespec.Pipeline, error)

	// List returns canonical spec records for one page of pipelines in an org.
	List(
		ctx context.Context,
		orgSlug, projectSlug slug.Slug,
		req model.ListRequest,
	) ([]*pipelinesrepo.PipelineSpec, error)

	// Exists reports whether a canonical pipeline spec exists for the given slugs.
	Exists(ctx context.Context, orgSlug, projectSlug, pipelineSlug slug.Slug) (bool, error)

	// ListVersions returns persisted versions for one pipeline, newest first.
	ListVersions(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
	) ([]*pipelinesrepo.PipelineVersion, error)

	// FindVersionBySpecHash returns a persisted version snapshot by spec hash.
	FindVersionBySpecHash(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
		specHash string,
	) (*pipelinesrepo.PipelineVersion, error)

	// FindVersionBySpecHashPrefix returns a persisted version snapshot by unique spec hash prefix.
	FindVersionBySpecHashPrefix(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
		specHashPrefix string,
	) (*pipelinesrepo.PipelineVersion, error)

	// Deploy points one project environment at an existing immutable version.
	Deploy(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		params pipelinesrepo.DeployParams,
	) (*pipelinesrepo.PipelineDeployment, error)

	// FindDeployment returns the current deployment pointer for one environment and pipeline.
	FindDeployment(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
	) (*pipelinesrepo.PipelineDeployment, error)

	// ListDeployments returns deployed pipeline pointers for one project environment.
	ListDeployments(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
	) ([]*pipelinesrepo.PipelineDeployment, error)
	ProjectEnvironmentEnabled(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
	) (bool, error)
	ProjectEnvironmentProtection(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
	) (*model.ProjectEnvironmentProtection, error)

	// FindDraft returns mutable draft metadata for a pipeline.
	FindDraft(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
	) (*pipelinesrepo.PipelineDraft, error)
	// SaveDraft upserts a mutable draft for a pipeline.
	SaveDraft(
		ctx context.Context,
		orgSlug, projectSlug slug.Slug,
		memberSlug slug.Slug,
		pipeline *pipelinespec.Pipeline,
		basedOnSpecHash *string,
	) error

	// PrepareGitDraftPublish records queued publish continuity for one Git-authored
	// draft inside the current unit of work and returns the outbound git write request.
	PrepareGitDraftPublish(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
		fallbackBaseRef *string,
		expectedSpecHash *string,
		force bool,
	) (*GitDraftPublishRequest, error)
	PrepareGitProposalRefresh(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
	) (*GitProposalRefreshRequest, error)
	CompleteProposal(ctx context.Context, completed pipelinegit.ProposalCompletion) error
	CompleteProposalRefresh(ctx context.Context, completed pipelinegit.ProposalRefreshCompletion) error
	FailProposal(ctx context.Context, failed pipelinegit.ProposalFailure) error
	FailProposalRefresh(ctx context.Context, failed pipelinegit.ProposalRefreshFailure) error

	// DeleteDraft removes a mutable draft for a pipeline.
	DeleteDraft(ctx context.Context, orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug) error

	// ReconcileFromGit scans Git-backed pipeline files and synchronizes DB-canonical
	// specs/references. It performs inbound Git-to-DB reconciliation only,
	// without outbound DB-to-Git side effects.
	ReconcileFromGit(
		ctx context.Context,
		orgSlug, projectSlug slug.Slug,
		repoStore repostore.RepoStore,
		params ReconcileFromGitParams,
	) (*ReconcileFromGitResult, error)
}

PipelineStore provides runtime access to pipeline specs materialized from Git.

func NewPipelineStore

NewPipelineStore creates a PipelineStore backed by the canonical DB spec table.

func NewPipelineStoreWithLogging

func NewPipelineStoreWithLogging(base PipelineStore, logger *slog.Logger) PipelineStore

NewPipelineStoreWithLogging wraps base with method completion logging.

type PipelineStoreWithLogging

type PipelineStoreWithLogging struct {
	// contains filtered or unexported fields
}

PipelineStoreWithLogging implements PipelineStore with method completion logging.

func (PipelineStoreWithLogging) CompleteProposal

func (_d PipelineStoreWithLogging) CompleteProposal(ctx context.Context, completed pipelinegit.ProposalCompletion) (err error)

CompleteProposal implements PipelineStore.

func (PipelineStoreWithLogging) CompleteProposalRefresh

func (_d PipelineStoreWithLogging) CompleteProposalRefresh(ctx context.Context, completed pipelinegit.ProposalRefreshCompletion) (err error)

CompleteProposalRefresh implements PipelineStore.

func (PipelineStoreWithLogging) DeleteDraft

func (_d PipelineStoreWithLogging) DeleteDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug) (err error)

DeleteDraft implements PipelineStore.

func (PipelineStoreWithLogging) Deploy

func (_d PipelineStoreWithLogging) Deploy(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, params pipelinesrepo.DeployParams) (pp1 *pipelinesrepo.PipelineDeployment, err error)

Deploy implements PipelineStore.

func (PipelineStoreWithLogging) Exists

func (_d PipelineStoreWithLogging) Exists(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug) (b1 bool, err error)

Exists implements PipelineStore.

func (PipelineStoreWithLogging) FailProposal

func (_d PipelineStoreWithLogging) FailProposal(ctx context.Context, failed pipelinegit.ProposalFailure) (err error)

FailProposal implements PipelineStore.

func (PipelineStoreWithLogging) FailProposalRefresh

func (_d PipelineStoreWithLogging) FailProposalRefresh(ctx context.Context, failed pipelinegit.ProposalRefreshFailure) (err error)

FailProposalRefresh implements PipelineStore.

func (PipelineStoreWithLogging) FindDeployment

func (_d PipelineStoreWithLogging) FindDeployment(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug) (pp1 *pipelinesrepo.PipelineDeployment, err error)

FindDeployment implements PipelineStore.

func (PipelineStoreWithLogging) FindDraft

func (_d PipelineStoreWithLogging) FindDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug) (pp1 *pipelinesrepo.PipelineDraft, err error)

FindDraft implements PipelineStore.

func (PipelineStoreWithLogging) FindSpec

func (_d PipelineStoreWithLogging) FindSpec(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug) (pp1 *pipelinesrepo.PipelineSpec, err error)

FindSpec implements PipelineStore.

func (PipelineStoreWithLogging) FindSpecForUpdate

func (_d PipelineStoreWithLogging) FindSpecForUpdate(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug) (pp1 *pipelinesrepo.PipelineSpec, err error)

FindSpecForUpdate implements PipelineStore.

func (PipelineStoreWithLogging) FindVersionBySpecHash

func (_d PipelineStoreWithLogging) FindVersionBySpecHash(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, specHash string) (pp1 *pipelinesrepo.PipelineVersion, err error)

FindVersionBySpecHash implements PipelineStore.

func (PipelineStoreWithLogging) FindVersionBySpecHashPrefix

func (_d PipelineStoreWithLogging) FindVersionBySpecHashPrefix(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, specHashPrefix string) (pp1 *pipelinesrepo.PipelineVersion, err error)

FindVersionBySpecHashPrefix implements PipelineStore.

func (PipelineStoreWithLogging) Get

func (_d PipelineStoreWithLogging) Get(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug) (pp1 *pipelinespec.Pipeline, err error)

Get implements PipelineStore.

func (PipelineStoreWithLogging) List

func (_d PipelineStoreWithLogging) List(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, req model.ListRequest) (ppa1 []*pipelinesrepo.PipelineSpec, err error)

List implements PipelineStore.

func (PipelineStoreWithLogging) ListDeployments

func (_d PipelineStoreWithLogging) ListDeployments(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug) (ppa1 []*pipelinesrepo.PipelineDeployment, err error)

ListDeployments implements PipelineStore.

func (PipelineStoreWithLogging) ListVersions

func (_d PipelineStoreWithLogging) ListVersions(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug) (ppa1 []*pipelinesrepo.PipelineVersion, err error)

ListVersions implements PipelineStore.

func (PipelineStoreWithLogging) PrepareGitDraftPublish

func (_d PipelineStoreWithLogging) PrepareGitDraftPublish(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug, fallbackBaseRef *string, expectedSpecHash *string, force bool) (gp1 *GitDraftPublishRequest, err error)

PrepareGitDraftPublish implements PipelineStore.

func (PipelineStoreWithLogging) PrepareGitProposalRefresh

func (_d PipelineStoreWithLogging) PrepareGitProposalRefresh(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug) (gp1 *GitProposalRefreshRequest, err error)

PrepareGitProposalRefresh implements PipelineStore.

func (PipelineStoreWithLogging) ProjectEnvironmentEnabled

func (_d PipelineStoreWithLogging) ProjectEnvironmentEnabled(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug) (b1 bool, err error)

ProjectEnvironmentEnabled implements PipelineStore.

func (PipelineStoreWithLogging) ProjectEnvironmentProtection

func (_d PipelineStoreWithLogging) ProjectEnvironmentProtection(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug) (pp1 *model.ProjectEnvironmentProtection, err error)

ProjectEnvironmentProtection implements PipelineStore.

func (PipelineStoreWithLogging) ReconcileFromGit

func (_d PipelineStoreWithLogging) ReconcileFromGit(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, repoStore repostore.RepoStore, params ReconcileFromGitParams) (rp1 *ReconcileFromGitResult, err error)

ReconcileFromGit implements PipelineStore.

func (PipelineStoreWithLogging) ResolvePipelineContracts

func (_d PipelineStoreWithLogging) ResolvePipelineContracts(ctx context.Context, s1 slug.Slug, s2 slug.Slug, pp1 *pipelinespec.Pipeline) (pp2 *pipelinespec.Pipeline, pa1 []model.PinnedODCSPort, err error)

ResolvePipelineContracts implements PipelineStore.

func (PipelineStoreWithLogging) ResolveProposalAuthority

func (_d PipelineStoreWithLogging) ResolveProposalAuthority(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug) (p1 model.PipelineProposalAuthority, err error)

ResolveProposalAuthority implements PipelineStore.

func (PipelineStoreWithLogging) SaveDraft

func (_d PipelineStoreWithLogging) SaveDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, memberSlug slug.Slug, pipeline *pipelinespec.Pipeline, basedOnSpecHash *string) (err error)

SaveDraft implements PipelineStore.

type PipelineSummary

type PipelineSummary struct {
	Slug                   slug.Slug
	Name                   string
	HasDraft               bool
	SyncStatus             pipelinesrepo.SyncStatus
	SourcePath             *string
	SourceRef              *string
	LastAppliedCommit      *string
	CreatedAt              time.Time
	UpdatedAt              time.Time
	CurrentVersionID       *int64
	CurrentVersionSpecHash *string
}

PipelineSummary contains persisted pipeline metadata used in CRUD responses.

type PipelineValidationDiagnostic

type PipelineValidationDiagnostic struct {
	Severity               string
	Code                   string
	Field                  string
	StepSlug               *string
	Message                string
	DataSourceRef          *string
	DataSourceRefSlug      *string
	ResolvedDataSourceSlug *string
	EnvironmentSlug        *string
	DataSourceType         *model.DataSourceType
	ExpectedDataSourceType *model.DataSourceType
	RequiredCapability     *model.DataSourceRefCapability
}

PipelineValidationDiagnostic is one validation finding for a submitted pipeline spec.

type PipelineValidationResult

type PipelineValidationResult struct {
	Valid             bool
	Diagnostics       []PipelineValidationDiagnostic
	ImpactReport      *DriftImpactReport
	DataSourceRefSync *datasourcerefssvc.PipelineDataSourceRefSyncResult
}

PipelineValidationResult contains structured validation diagnostics for API and CLI callers.

type PipelineValidationResultFilters

type PipelineValidationResultFilters struct {
	PipelineSlug *slug.Slug
	Limit        int32
}

PipelineValidationResultFilters narrows validation-history reads for SSR panels and API callers.

type PipelineValidationResultRecord

type PipelineValidationResultRecord struct {
	Slug             slug.Slug
	ProjectSlug      slug.Slug
	EnvironmentSlug  slug.Slug
	PipelineSlug     slug.Slug
	Source           PipelineValidationResultSource
	Valid            bool
	SpecHash         *string
	Diagnostics      []PipelineValidationDiagnostic
	ImpactReportSlug *slug.Slug
	CreatedAt        time.Time
	UpdatedAt        time.Time
}

PipelineValidationResultRecord is a durable non-run validation result for SSR triage.

type PipelineValidationResultSource

type PipelineValidationResultSource int

PipelineValidationResultSource identifies the product boundary that recorded a validation result.

const (
	PipelineValidationResultSourceUnknown    PipelineValidationResultSource = iota // unknown
	PipelineValidationResultSourceAPI                                              // api
	PipelineValidationResultSourceExecute                                          // execute
	PipelineValidationResultSourceRevalidate                                       // revalidate
)

func PipelineValidationResultSourceString

func PipelineValidationResultSourceString(s string) (PipelineValidationResultSource, error)

PipelineValidationResultSourceString retrieves an enum value from the enum constants string name. Throws an error if the param is not part of the enum.

func PipelineValidationResultSourceValues

func PipelineValidationResultSourceValues() []PipelineValidationResultSource

PipelineValidationResultSourceValues returns all values of the enum

func (PipelineValidationResultSource) IsAPipelineValidationResultSource

func (i PipelineValidationResultSource) IsAPipelineValidationResultSource() bool

IsAPipelineValidationResultSource returns "true" if the value is listed in the enum definition. "false" otherwise

func (PipelineValidationResultSource) MarshalJSON

func (i PipelineValidationResultSource) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface for PipelineValidationResultSource

func (PipelineValidationResultSource) MarshalText

func (i PipelineValidationResultSource) MarshalText() ([]byte, error)

MarshalText implements the encoding.TextMarshaler interface for PipelineValidationResultSource

func (PipelineValidationResultSource) String

func (*PipelineValidationResultSource) UnmarshalJSON

func (i *PipelineValidationResultSource) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface for PipelineValidationResultSource

func (*PipelineValidationResultSource) UnmarshalText

func (i *PipelineValidationResultSource) UnmarshalText(text []byte) error

UnmarshalText implements the encoding.TextUnmarshaler interface for PipelineValidationResultSource

type PipelineVersionDetail

type PipelineVersionDetail struct {
	Summary *PipelineVersionSummary
	Spec    *pipelinespec.Pipeline
}

PipelineVersionDetail contains immutable version metadata plus the stored spec snapshot.

type PipelineVersionSummary

type PipelineVersionSummary struct {
	SpecHash      string
	ShortSpecHash string
	PipelineSlug  slug.Slug
	GitCommitSHA  *string
	CreatedAt     time.Time
}

PipelineVersionSummary contains immutable version metadata used in list responses.

type ProofLifecycleLink struct {
	Kind        model.ProofLifecycleLinkKind
	ReceiptSlug slug.Slug
	Identifier  string
	LinkedAt    time.Time
	RetainUntil time.Time
	Status      string
}

type ProposalLifecycle

type ProposalLifecycle struct {
	// contains filtered or unexported fields
}

ProposalLifecycle keeps creation state separate from imported-pipeline drafts.

func NewProposalLifecycle

func NewProposalLifecycle(updates proposalUpdateRecorder, authorizer proposalUpdateAuthorizer, creations *CreationService) (*ProposalLifecycle, error)

func (*ProposalLifecycle) AuthorizeProposalPublish

func (s *ProposalLifecycle) AuthorizeProposalPublish(ctx context.Context, args jobs.PipelineGitPublishProposalArgs) error

func (*ProposalLifecycle) CompleteProposal

func (s *ProposalLifecycle) CompleteProposal(ctx context.Context, completed pipelinegit.ProposalCompletion) error

func (*ProposalLifecycle) CompleteProposalRefresh

func (s *ProposalLifecycle) CompleteProposalRefresh(ctx context.Context, completed pipelinegit.ProposalRefreshCompletion) error

func (*ProposalLifecycle) FailProposal

func (s *ProposalLifecycle) FailProposal(ctx context.Context, failed pipelinegit.ProposalFailure) error

func (*ProposalLifecycle) FailProposalRefresh

func (s *ProposalLifecycle) FailProposalRefresh(ctx context.Context, failed pipelinegit.ProposalRefreshFailure) error

type ReconcileFromGitDeleted

type ReconcileFromGitDeleted struct {
	PipelineSlug       string
	PreviousSourcePath *string
}

ReconcileFromGitDeleted captures one stale Git-authored DB pipeline removed by reconcile.

type ReconcileFromGitFailure

type ReconcileFromGitFailure struct {
	PipelinePath string
	PipelineSlug string
	Stage        string
	Message      string
}

ReconcileFromGitFailure captures one pipeline-level failure during reconcile.

type ReconcileFromGitParams

type ReconcileFromGitParams struct {
	PipelineDir          string
	PipelineSlugs        []slug.Slug
	SourceDataSourceSlug *slug.Slug
	SourceRepo           *string
	SourceRef            *string
	LastAppliedCommit    *string
	DryRun               bool
}

ReconcileFromGitParams controls a single org-scoped reconcile run.

SourceRepo and SourceRef record reconcile provenance for audit, drift reporting, and replay.

type ReconcileFromGitReset

type ReconcileFromGitReset struct {
	PipelineSlug     string
	SourcePath       string
	PreviousSpecHash string
	AppliedSpecHash  string
}

ReconcileFromGitReset captures one git reconcile that replaced a drifted DB spec.

type ReconcileFromGitResult

type ReconcileFromGitResult struct {
	Scanned               int
	Upserted              int
	Synced                int
	Deleted               int
	Skipped               int
	ResetDrifted          int
	Failed                int
	SyncedPipelines       []ReconcileFromGitSynced
	DeletedPipelines      []ReconcileFromGitDeleted
	SkippedPipelines      []ReconcileFromGitSkipped
	ResetDriftedPipelines []ReconcileFromGitReset
	Failures              []ReconcileFromGitFailure
}

ReconcileFromGitResult captures the effect of one reconcile run.

type ReconcileFromGitSkipped

type ReconcileFromGitSkipped struct {
	PipelineSlug string
	SourcePath   *string
	Reason       string
}

ReconcileFromGitSkipped captures one pipeline intentionally skipped by reconcile.

type ReconcileFromGitSynced

type ReconcileFromGitSynced struct {
	PipelineSlug string
	SourcePath   string
	SpecHash     string
}

ReconcileFromGitSynced captures one git spec synchronized into DB-canonical storage.

type ReconcilePipelinesDeletedPipeline

type ReconcilePipelinesDeletedPipeline struct {
	PipelineSlug       slug.Slug
	PreviousSourcePath *string
}

type ReconcilePipelinesDriftReset

type ReconcilePipelinesDriftReset struct {
	PipelineSlug     slug.Slug
	SourcePath       string
	PreviousSpecHash string
	AppliedSpecHash  string
}

type ReconcilePipelinesExpectedSource

type ReconcilePipelinesExpectedSource struct {
	DataSourceSlug slug.Slug
	Repo           string
	Ref            string
	Commit         string
}

type ReconcilePipelinesFailure

type ReconcilePipelinesFailure struct {
	PipelinePath *string
	PipelineSlug *slug.Slug
	Stage        string
	Message      string
}

type ReconcilePipelinesRequest

type ReconcilePipelinesRequest struct {
	ExpectedSource *ReconcilePipelinesExpectedSource
	DryRun         bool
	PipelineDir    string
	PipelineSlugs  []slug.Slug
}

ReconcilePipelinesRequest controls one API-driven pipeline reconcile operation.

type ReconcilePipelinesResult

type ReconcilePipelinesResult struct {
	DryRun                 bool
	PipelineDir            string
	RequestedPipelineSlugs []slug.Slug
	Source                 ReconcilePipelinesSourceMetadata
	Summary                ReconcilePipelinesSummary
	Synced                 []ReconcilePipelinesSyncedPipeline
	Deleted                []ReconcilePipelinesDeletedPipeline
	Skipped                []ReconcilePipelinesSkippedPipeline
	DriftResets            []ReconcilePipelinesDriftReset
	Failures               []ReconcilePipelinesFailure
}

ReconcilePipelinesResult reports the effect of one API-driven reconcile operation.

type ReconcilePipelinesSkippedPipeline

type ReconcilePipelinesSkippedPipeline struct {
	PipelineSlug slug.Slug
	SourcePath   *string
	Reason       string
}

type ReconcilePipelinesSourceMetadata

type ReconcilePipelinesSourceMetadata struct {
	DataSourceSlug *slug.Slug
	Repo           *string
	Ref            *string
	Commit         *string
}

ReconcilePipelinesSourceMetadata captures source metadata recorded on reconciled specs.

type ReconcilePipelinesSummary

type ReconcilePipelinesSummary struct {
	Scanned    int
	Synced     int
	Deleted    int
	Skipped    int
	Failed     int
	DriftReset int
}

ReconcilePipelinesSummary contains aggregate reconcile counters.

type ReconcilePipelinesSyncedPipeline

type ReconcilePipelinesSyncedPipeline struct {
	PipelineSlug slug.Slug
	SourcePath   string
	SpecHash     string
}

type RunCompositionInspection

type RunCompositionInspection struct {
	AdmissionEnabled                                                           bool
	Status, TemplateDigest, CompiledPlanDigest, ResolutionDigest, SourceCommit string
	Pins                                                                       []RunContractPinInspection
	Operations                                                                 []RunOperationInspection
	Targets                                                                    []RunTargetInspection
}

RunCompositionInspection deliberately excludes document, operation and input values.

type RunContractPinInspection

type RunContractPinInspection struct {
	Step                                                slug.Slug
	Port, Origin                                        string
	Contract, Revision                                  slug.Slug
	Object, Digest, Compiler, Representation, RootShape string
}

type RunFilters

type RunFilters struct {
	Status             *string
	PipelineSlug       *slug.Slug
	Mode               *string
	BackfillSeriesSlug *string
}

RunFilters constrains list-runs results.

type RunOperationInspection

type RunOperationInspection struct {
	Step, Operation        slug.Slug
	Role, Revision, Digest string
	ResourceScope          *resourcescope.Identity
}

type RunProgress

type RunProgress struct {
	CompiledPlanDigest, DeploymentResolutionDigest              *string
	CompletedSteps, FailedSteps, PendingSteps, InterruptedSteps int
	CurrentStep                                                 *string
	Metadata                                                    PipelineRunMetadata
	Revision, AfterEvent, NextAfterEvent, EventCount            int64
	Events                                                      []pipelinerun.TimelineEvent
	HasMore                                                     bool
	WorkerObservedAt, ObservedAt                                *time.Time
	WorkerLiveness                                              pipelinerun.WorkerLiveness
	ServerTime                                                  time.Time
}

type RunTargetInspection

type RunTargetInspection struct {
	Step, Reference, DataSource slug.Slug
	Role, BindingRevision       string
}

type Service

type Service interface {
	AcceptQueuedRun(context.Context, slug.Slug, slug.Slug, slug.Slug, slug.Slug, slug.Slug, pipelinerun.RunSourceSummary, time.Time, int64) error
	StartQueuedRun(context.Context, slug.Slug, slug.Slug, slug.Slug, slug.Slug, time.Time) error
	ReconcileInterruptedRuns(context.Context, time.Time) error
	FailUnadmittedRun(context.Context, slug.Slug, slug.Slug, slug.Slug, slug.Slug) error
	GetRunCompletion(context.Context, slug.Slug, slug.Slug, slug.Slug, slug.Slug) (*model.PipelineRunCompletion, error)
	AcceptCompletionRun(context.Context, slug.Slug, slug.Slug, slug.Slug, *model.PipelineCompletionSnapshot) (jobs.PipelineRunExecutionArgs, error)
	AcceptCompletionRetryRun(context.Context, slug.Slug, slug.Slug, slug.Slug, *model.PipelineCompletionSnapshot, slug.Slug, pipelinerun.RunSourceSummary, time.Time) (jobs.PipelineRunExecutionArgs, error)
	ExecuteCompletionPipelineRun(context.Context, jobs.PipelineRunExecutionArgs, CompletionAuthorityChecker) error
	ValidateCompletionExecutionContext(context.Context, slug.Slug, slug.Slug, slug.Slug, *model.PipelineCompletionSnapshot) error
	BootstrapCheckpoints(ctx context.Context, orgSlug, projectSlug, environmentSlug, pipelineSlug, requestSlug slug.Slug, confirmation *slug.Slug, actor model.EventActor, input map[string]any, seeds map[slug.Slug]json.RawMessage) error

	RecoverRun(ctx context.Context, orgSlug, projectSlug, environmentSlug, sourceRunSlug slug.Slug, confirmation *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary) (*PipelineRunDetail, error)
	List(
		ctx context.Context,
		orgSlug, projectSlug, memberSlug slug.Slug,
		req model.ListRequest,
	) (model.ListResponse[*PipelineSummary], error)
	Get(ctx context.Context, orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug) (*PipelineDetail, error)
	GetDraft(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
	) (*PipelineDraftDetail, error)
	SaveDraft(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
		actor model.EventActor,
		pipeline *pipelinespec.Pipeline,
		expectedSpecHash *string,
	) (*PipelineDraftDetail, error)
	PublishDraft(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
		actor model.EventActor,
		expectedSpecHash *string,
		force bool,
	) (*PipelineDetail, error)
	AuthorizeProposalPublish(ctx context.Context, args jobs.PipelineGitPublishProposalArgs) error
	RefreshDraftProposal(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
		actor model.EventActor,
	) (*PipelineDetail, error)
	DeleteDraft(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
		actor model.EventActor,
	) error
	ListVersions(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
	) ([]*PipelineVersionSummary, error)
	GetVersion(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug slug.Slug,
		specHash string,
	) (*PipelineVersionDetail, error)
	ListDeployments(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
	) ([]*PipelineDeploymentDetail, error)
	GetDeployment(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
	) (*PipelineDeploymentDetail, error)
	Deploy(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		actor model.EventActor,
		req DeployPipelineRequest,
	) (*PipelineDeploymentDetail, error)
	Update(
		ctx context.Context,
		orgSlug, projectSlug, pipelineSlug, memberSlug slug.Slug,
		actor model.EventActor,
		pipeline *pipelinespec.Pipeline,
	) (*PipelineDetail, error)
	ReconcilePipelines(
		ctx context.Context,
		orgSlug, projectSlug, memberSlug slug.Slug,
		actor model.EventActor,
		req ReconcilePipelinesRequest,
	) (*ReconcilePipelinesResult, error)
	Validate(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, memberSlug slug.Slug,
		pipeline *pipelinespec.Pipeline,
	) (*PipelineValidationResult, error)
	RecordValidationResult(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		principal ValidationHistoryPrincipal,
		source PipelineValidationResultSource,
		pipeline *pipelinespec.Pipeline,
		result *PipelineValidationResult,
	) (*PipelineValidationResultRecord, error)
	ListValidationResults(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		principal ValidationHistoryPrincipal,
		filters PipelineValidationResultFilters,
		req model.ListRequest,
	) (model.ListResponse[*PipelineValidationResultRecord], error)
	GetValidationResult(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		principal ValidationHistoryPrincipal,
		resultSlug slug.Slug,
	) (*PipelineValidationResultRecord, error)
	RevalidatePipeline(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		principal ValidationHistoryPrincipal,
		pipelineSlug, memberSlug slug.Slug,
	) (*PipelineValidationResultRecord, error)
	ListDriftImpactReports(
		ctx context.Context,
		orgSlug slug.Slug,
		filters DriftImpactReportFilters,
	) ([]*DriftImpactReport, error)
	GetDriftImpactReport(ctx context.Context, orgSlug, projectSlug, reportSlug slug.Slug) (*DriftImpactReport, error)
	Execute(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		runSlug *slug.Slug,
		protectedEnvironmentConfirmation *slug.Slug,
		actor model.EventActor,
		source pipelinerun.RunSourceSummary,
		runtimeInput map[string]any,
	) (*PipelineRunDetail, error)
	StartRun(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		runSlug *slug.Slug,
		protectedEnvironmentConfirmation *slug.Slug,
		actor model.EventActor,
		source pipelinerun.RunSourceSummary,
		runtimeInput map[string]any,
	) (*PipelineRunDetail, error)
	StartBackfill(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		runSlug *slug.Slug,
		protectedEnvironmentConfirmation *slug.Slug,
		actor model.EventActor,
		source pipelinerun.RunSourceSummary,
		runtimeInput map[string]any,
		windows map[slug.Slug]pipelinerun.IncrementalSourceWindow,
	) (*PipelineRunDetail, error)
	ExecuteQueuedPipelineRun(ctx context.Context, args jobs.PipelineRunExecutionArgs) error
	ExecuteVersion(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		specHash string,
		runSlug *slug.Slug,
		protectedEnvironmentConfirmation *slug.Slug,
		actor model.EventActor,
		source pipelinerun.RunSourceSummary,
		runtimeInput map[string]any,
	) (*PipelineRunDetail, error)
	ExecuteVerifiedEvent(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		runSlug *slug.Slug,
		actor model.EventActor,
		source pipelinerun.RunSourceSummary,
		runtimeInput map[string]any,
		eventInputJSON json.RawMessage,
	) (*PipelineRunDetail, error)
	ExecuteVerifiedEventVersion(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug, pipelineSlug slug.Slug,
		specHash string,
		runSlug *slug.Slug,
		actor model.EventActor,
		source pipelinerun.RunSourceSummary,
		runtimeInput map[string]any,
		eventInputJSON json.RawMessage,
	) (*PipelineRunDetail, error)
	ListRuns(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		filters *RunFilters,
		req model.ListRequest,
	) (model.ListResponse[*PipelineRunMetadata], error)
	GetRun(
		ctx context.Context,
		orgSlug, projectSlug, environmentSlug slug.Slug,
		runSlug string,
	) (*PipelineRunDetail, error)
	GetRunProgress(context.Context, slug.Slug, slug.Slug, slug.Slug, string, int64, int) (*RunProgress, error)
}

Service exposes pipelines operations

func New

func New(
	compiledPlans *compiledplans.Repository,
	resolutions *deploymentresolutions.Repository,
	pipelineStore PipelineStore,
	dbtx postgres.DBTX,
	txm postgres.TransactionManager,
	runRepo pipelineruns.Repository,
	checkpoints incrementalcheckpoints.Repository,
	runStore pipelinerun.RunStore,
	driftReports driftimpactrepo.Repository,
	queryExecutor queryExecutor,
	authorizationService authorization.Service,
	admission admissionsvc.Service,
	dataSourceService datasourcessvc.Service,
	projectBackend pipelinegit.ProjectBackendService,
	gitSourceResolver pipelinegit.SourceResolver,
	clk clock.Clock,
	pipelineRunProducer workerproducer.PipelineRunProducer,
	pipelineGitProducer workerproducer.PipelineGitProducer,
	eventProducer workerproducer.EventProducer,
	runtimeResolver pipelineRuntimeResolver,
	sinkEffectLedger pipelinerun.SinkEffectLedger,
	proofLinks proofreceipts.LifecycleRepository,
	notificationProducer notificationsvc.CandidateProducer,
	options ...ServiceOption,
) (Service, error)

New creates a pipeline service with strict dependency requirements.

func NewServiceWithLogging

func NewServiceWithLogging(base Service, logger *slog.Logger) Service

NewServiceWithLogging wraps base with method completion logging.

type ServiceOption

type ServiceOption func(*serviceOptions)

ServiceOption configures pipeline runtime safety boundaries.

func WithTransformExecutor

func WithTransformExecutor(executor pipelineruntime.TransformExecutor) ServiceOption

WithTransformExecutor routes transform materialization to an isolated executor.

func WithTransformLimits

func WithTransformLimits(limits transformsql.Limits) ServiceOption

WithTransformLimits applies cumulative budgets to pipeline SQL transforms.

type ServiceWithLogging

type ServiceWithLogging struct {
	// contains filtered or unexported fields
}

ServiceWithLogging implements Service with method completion logging.

func (ServiceWithLogging) AcceptCompletionRetryRun

AcceptCompletionRetryRun implements Service.

func (ServiceWithLogging) AcceptCompletionRun

AcceptCompletionRun implements Service.

func (ServiceWithLogging) AcceptQueuedRun

func (_d ServiceWithLogging) AcceptQueuedRun(ctx context.Context, s1 slug.Slug, s2 slug.Slug, s3 slug.Slug, s4 slug.Slug, s5 slug.Slug, r1 pipelinerun.RunSourceSummary, t1 time.Time, i1 int64) (err error)

AcceptQueuedRun implements Service.

func (ServiceWithLogging) AuthorizeProposalPublish

func (_d ServiceWithLogging) AuthorizeProposalPublish(ctx context.Context, args jobs.PipelineGitPublishProposalArgs) (err error)

AuthorizeProposalPublish implements Service.

func (ServiceWithLogging) BootstrapCheckpoints

func (_d ServiceWithLogging) BootstrapCheckpoints(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, requestSlug slug.Slug, confirmation *slug.Slug, actor model.EventActor, input map[string]any, seeds map[slug.Slug]json.RawMessage) (err error)

BootstrapCheckpoints implements Service.

func (ServiceWithLogging) DeleteDraft

func (_d ServiceWithLogging) DeleteDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug, actor model.EventActor) (err error)

DeleteDraft implements Service.

func (ServiceWithLogging) Deploy

func (_d ServiceWithLogging) Deploy(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, actor model.EventActor, req DeployPipelineRequest) (pp1 *PipelineDeploymentDetail, err error)

Deploy implements Service.

func (ServiceWithLogging) Execute

func (_d ServiceWithLogging) Execute(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, runSlug *slug.Slug, protectedEnvironmentConfirmation *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary, runtimeInput map[string]any) (pp1 *PipelineRunDetail, err error)

Execute implements Service.

func (ServiceWithLogging) ExecuteCompletionPipelineRun

func (_d ServiceWithLogging) ExecuteCompletionPipelineRun(ctx context.Context, p1 jobs.PipelineRunExecutionArgs, c2 CompletionAuthorityChecker) (err error)

ExecuteCompletionPipelineRun implements Service.

func (ServiceWithLogging) ExecuteQueuedPipelineRun

func (_d ServiceWithLogging) ExecuteQueuedPipelineRun(ctx context.Context, args jobs.PipelineRunExecutionArgs) (err error)

ExecuteQueuedPipelineRun implements Service.

func (ServiceWithLogging) ExecuteVerifiedEvent

func (_d ServiceWithLogging) ExecuteVerifiedEvent(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, runSlug *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary, runtimeInput map[string]any, eventInputJSON json.RawMessage) (pp1 *PipelineRunDetail, err error)

ExecuteVerifiedEvent implements Service.

func (ServiceWithLogging) ExecuteVerifiedEventVersion

func (_d ServiceWithLogging) ExecuteVerifiedEventVersion(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, specHash string, runSlug *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary, runtimeInput map[string]any, eventInputJSON json.RawMessage) (pp1 *PipelineRunDetail, err error)

ExecuteVerifiedEventVersion implements Service.

func (ServiceWithLogging) ExecuteVersion

func (_d ServiceWithLogging) ExecuteVersion(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, specHash string, runSlug *slug.Slug, protectedEnvironmentConfirmation *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary, runtimeInput map[string]any) (pp1 *PipelineRunDetail, err error)

ExecuteVersion implements Service.

func (ServiceWithLogging) FailUnadmittedRun

func (_d ServiceWithLogging) FailUnadmittedRun(ctx context.Context, s1 slug.Slug, s2 slug.Slug, s3 slug.Slug, s4 slug.Slug) (err error)

FailUnadmittedRun implements Service.

func (ServiceWithLogging) Get

func (_d ServiceWithLogging) Get(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug) (pp1 *PipelineDetail, err error)

Get implements Service.

func (ServiceWithLogging) GetDeployment

func (_d ServiceWithLogging) GetDeployment(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug) (pp1 *PipelineDeploymentDetail, err error)

GetDeployment implements Service.

func (ServiceWithLogging) GetDraft

func (_d ServiceWithLogging) GetDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug) (pp1 *PipelineDraftDetail, err error)

GetDraft implements Service.

func (ServiceWithLogging) GetDriftImpactReport

func (_d ServiceWithLogging) GetDriftImpactReport(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, reportSlug slug.Slug) (dp1 *DriftImpactReport, err error)

GetDriftImpactReport implements Service.

func (ServiceWithLogging) GetRun

func (_d ServiceWithLogging) GetRun(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, runSlug string) (pp1 *PipelineRunDetail, err error)

GetRun implements Service.

func (ServiceWithLogging) GetRunCompletion

func (_d ServiceWithLogging) GetRunCompletion(ctx context.Context, s1 slug.Slug, s2 slug.Slug, s3 slug.Slug, s4 slug.Slug) (pp1 *model.PipelineRunCompletion, err error)

GetRunCompletion implements Service.

func (ServiceWithLogging) GetRunProgress

func (_d ServiceWithLogging) GetRunProgress(ctx context.Context, s1 slug.Slug, s2 slug.Slug, s3 slug.Slug, s4 string, i1 int64, i2 int) (rp1 *RunProgress, err error)

GetRunProgress implements Service.

func (ServiceWithLogging) GetValidationResult

func (_d ServiceWithLogging) GetValidationResult(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, principal ValidationHistoryPrincipal, resultSlug slug.Slug) (pp1 *PipelineValidationResultRecord, err error)

GetValidationResult implements Service.

func (ServiceWithLogging) GetVersion

func (_d ServiceWithLogging) GetVersion(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, specHash string) (pp1 *PipelineVersionDetail, err error)

GetVersion implements Service.

func (ServiceWithLogging) List

func (_d ServiceWithLogging) List(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, memberSlug slug.Slug, req model.ListRequest) (p1 model.ListResponse[*PipelineSummary], err error)

List implements Service.

func (ServiceWithLogging) ListDeployments

func (_d ServiceWithLogging) ListDeployments(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug) (ppa1 []*PipelineDeploymentDetail, err error)

ListDeployments implements Service.

func (ServiceWithLogging) ListDriftImpactReports

func (_d ServiceWithLogging) ListDriftImpactReports(ctx context.Context, orgSlug slug.Slug, filters DriftImpactReportFilters) (dpa1 []*DriftImpactReport, err error)

ListDriftImpactReports implements Service.

func (ServiceWithLogging) ListRuns

func (_d ServiceWithLogging) ListRuns(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, filters *RunFilters, req model.ListRequest) (p1 model.ListResponse[*PipelineRunMetadata], err error)

ListRuns implements Service.

func (ServiceWithLogging) ListValidationResults

func (_d ServiceWithLogging) ListValidationResults(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, principal ValidationHistoryPrincipal, filters PipelineValidationResultFilters, req model.ListRequest) (p1 model.ListResponse[*PipelineValidationResultRecord], err error)

ListValidationResults implements Service.

func (ServiceWithLogging) ListVersions

func (_d ServiceWithLogging) ListVersions(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug) (ppa1 []*PipelineVersionSummary, err error)

ListVersions implements Service.

func (ServiceWithLogging) PublishDraft

func (_d ServiceWithLogging) PublishDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug, actor model.EventActor, expectedSpecHash *string, force bool) (pp1 *PipelineDetail, err error)

PublishDraft implements Service.

func (ServiceWithLogging) ReconcileInterruptedRuns

func (_d ServiceWithLogging) ReconcileInterruptedRuns(ctx context.Context, t1 time.Time) (err error)

ReconcileInterruptedRuns implements Service.

func (ServiceWithLogging) ReconcilePipelines

func (_d ServiceWithLogging) ReconcilePipelines(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, memberSlug slug.Slug, actor model.EventActor, req ReconcilePipelinesRequest) (rp1 *ReconcilePipelinesResult, err error)

ReconcilePipelines implements Service.

func (ServiceWithLogging) RecordValidationResult

func (_d ServiceWithLogging) RecordValidationResult(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, principal ValidationHistoryPrincipal, source PipelineValidationResultSource, pipeline *pipelinespec.Pipeline, result *PipelineValidationResult) (pp1 *PipelineValidationResultRecord, err error)

RecordValidationResult implements Service.

func (ServiceWithLogging) RecoverRun

func (_d ServiceWithLogging) RecoverRun(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, sourceRunSlug slug.Slug, confirmation *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary) (pp1 *PipelineRunDetail, err error)

RecoverRun implements Service.

func (ServiceWithLogging) RefreshDraftProposal

func (_d ServiceWithLogging) RefreshDraftProposal(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug, actor model.EventActor) (pp1 *PipelineDetail, err error)

RefreshDraftProposal implements Service.

func (ServiceWithLogging) RevalidatePipeline

func (_d ServiceWithLogging) RevalidatePipeline(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, principal ValidationHistoryPrincipal, pipelineSlug slug.Slug, memberSlug slug.Slug) (pp1 *PipelineValidationResultRecord, err error)

RevalidatePipeline implements Service.

func (ServiceWithLogging) SaveDraft

func (_d ServiceWithLogging) SaveDraft(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug, actor model.EventActor, pipeline *pipelinespec.Pipeline, expectedSpecHash *string) (pp1 *PipelineDraftDetail, err error)

SaveDraft implements Service.

func (ServiceWithLogging) StartBackfill

func (_d ServiceWithLogging) StartBackfill(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, runSlug *slug.Slug, protectedEnvironmentConfirmation *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary, runtimeInput map[string]any, windows map[slug.Slug]pipelinerun.IncrementalSourceWindow) (pp1 *PipelineRunDetail, err error)

StartBackfill implements Service.

func (ServiceWithLogging) StartQueuedRun

func (_d ServiceWithLogging) StartQueuedRun(ctx context.Context, s1 slug.Slug, s2 slug.Slug, s3 slug.Slug, s4 slug.Slug, t1 time.Time) (err error)

StartQueuedRun implements Service.

func (ServiceWithLogging) StartRun

func (_d ServiceWithLogging) StartRun(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, pipelineSlug slug.Slug, runSlug *slug.Slug, protectedEnvironmentConfirmation *slug.Slug, actor model.EventActor, source pipelinerun.RunSourceSummary, runtimeInput map[string]any) (pp1 *PipelineRunDetail, err error)

StartRun implements Service.

func (ServiceWithLogging) Update

func (_d ServiceWithLogging) Update(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, pipelineSlug slug.Slug, memberSlug slug.Slug, actor model.EventActor, pipeline *pipelinespec.Pipeline) (pp1 *PipelineDetail, err error)

Update implements Service.

func (ServiceWithLogging) Validate

func (_d ServiceWithLogging) Validate(ctx context.Context, orgSlug slug.Slug, projectSlug slug.Slug, environmentSlug slug.Slug, memberSlug slug.Slug, pipeline *pipelinespec.Pipeline) (pp1 *PipelineValidationResult, err error)

Validate implements Service.

func (ServiceWithLogging) ValidateCompletionExecutionContext

func (_d ServiceWithLogging) ValidateCompletionExecutionContext(ctx context.Context, s1 slug.Slug, s2 slug.Slug, s3 slug.Slug, pp1 *model.PipelineCompletionSnapshot) (err error)

ValidateCompletionExecutionContext implements Service.

type ValidationHistoryPrincipal

type ValidationHistoryPrincipal struct {
	UserSlug       slug.Slug
	APIKeySlug     slug.Slug
	APIKeyOrgSlug  slug.Slug
	APIKeyRoleSlug slug.Slug
}

ValidationHistoryPrincipal carries the authenticated actor used for validation-history authorization.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL