workspace

type ArtifactStore interface {
	RegisterArtifactFrontend(frontend artifactstoreSpec.ArtifactFrontend) error
	RegisterRootKindHook(hook artifactstoreSpec.RootKindHook) error
	RegisterCollectionKindHook(hook artifactstoreSpec.CollectionKindHook) error

	CreateRoot(ctx context.Context, draft artifactstoreSpec.RootDraft) (artifactstoreSpec.ArtifactRoot, error)
	GetRoot(ctx context.Context, rootID artifactstoreSpec.RootID) (artifactstoreSpec.ArtifactRoot, error)
	ListRoots(ctx context.Context, includeSoftDeleted bool) ([]artifactstoreSpec.ArtifactRoot, error)
	DeleteRoot(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		expectedModifiedAt time.Time,
	) (artifactstoreSpec.ArtifactRoot, error)

	CreateSource(ctx context.Context, draft artifactstoreSpec.SourceDraft) (artifactstoreSpec.ArtifactSource, error)
	DeleteSource(
		ctx context.Context,
		sourceID artifactstoreSpec.SourceID,
		expectedModifiedAt time.Time,
	) error
	AttachSource(
		ctx context.Context,
		draft artifactstore.RootSourceAttachmentDraft,
	) (artifactstoreSpec.RootSourceAttachment, error)
	GetRootSourceAttachment(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		sourceID artifactstoreSpec.SourceID,
	) (artifactstoreSpec.RootSourceAttachment, error)
	ListRootSources(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
	) ([]artifactstoreSpec.RootSourceAttachment, error)
	DetachSource(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		sourceID artifactstoreSpec.SourceID,
		expectedModifiedAt time.Time,
	) error

	ScanRoot(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		plan artifactstoreSpec.ScanPlan,
	) (artifactstoreSpec.ScanResult, error)
	GetRootCatalogGeneration(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
	) (artifactstoreSpec.RootCatalogGeneration, error)
	ListCatalogResourcesForRoot(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
	) ([]artifactstoreSpec.CatalogResource, error)
	GetDefinitionByDigest(
		ctx context.Context,
		digest artifactstoreSpec.Digest,
	) (artifactstoreSpec.CanonicalDefinition, error)

	EnsureBaseCollection(
		ctx context.Context,
		draft artifactstoreSpec.CollectionDraft,
	) (artifactstoreSpec.ArtifactCollection, error)
	ListCollections(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		includeSoftDeleted bool,
	) ([]artifactstoreSpec.ArtifactCollection, error)
	ListRecords(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
	) ([]artifactstoreSpec.ArtifactRecord, error)
	GetRecord(
		ctx context.Context,
		recordID artifactstoreSpec.RecordID,
	) (artifactstoreSpec.ArtifactRecord, error)
	SyncRecords(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		policy artifactstoreSpec.RecordSyncPolicy,
	) (artifactstoreSpec.RecordSyncResult, error)
	FindCandidates(
		ctx context.Context,
		rootID artifactstoreSpec.RootID,
		selector artifactstoreSpec.ArtifactSelector,
	) ([]artifactstoreSpec.DependencyCandidate, error)
	BuildDependencyGraph(
		ctx context.Context,
		recordID artifactstoreSpec.RecordID,
	) (artifactstoreSpec.DependencyGraph, error)
}

type AttachSourceRequest struct {
	RootID              artifactstoreSpec.RootID
	SourceID            artifactstoreSpec.SourceID
	Role                artifactstoreSpec.AttachmentRole
	Priority            int
	AttachmentData      AttachmentData
	DiscoverImmediately bool
}

type AttachedPackagePreferences struct {
	DiscoverRecursively bool `json:"discoverRecursively,omitempty"`
}

type AttachmentData struct {
	Recursive     *bool `json:"recursive,omitempty"`
	Authoritative *bool `json:"authoritative,omitempty"`
}

type Catalog struct {
	Workspace  Workspace
	Generation artifactstoreSpec.RootCatalogGeneration
	Resources  []CatalogResource
	Unrecorded []artifactstoreSpec.CatalogResource
}

type CatalogResource struct {
	Record         artifactstoreSpec.ArtifactRecord
	Definition     artifactstoreSpec.CanonicalDefinition
	Collection     *artifactstoreSpec.ArtifactCollection
	Occurrence     *artifactstoreSpec.CatalogResource
	CatalogCurrent bool
}

type CollectionData struct {
	ArtifactKind artifactstoreSpec.ArtifactKind `json:"artifactKind"`
}

type DiscoveryInput struct {
	Workspace             Workspace
	DefinitionPreferences DiscoveryPreferences
	FrontendIDs           []artifactstoreSpec.FrontendID
}

type DiscoveryPlanner interface {
	BuildBootstrapPlan(ctx context.Context, input DiscoveryInput) (artifactstoreSpec.ScanPlan, error)
	BuildExpandedPlan(ctx context.Context, input DiscoveryInput) (artifactstoreSpec.ScanPlan, error)
}

type DiscoveryPreferences struct {
	AdditionalLocators []artifactstoreSpec.SourceLocator `json:"additionalLocators,omitempty"`
	AdditionalRoots    []DiscoveryRoot                   `json:"additionalRoots,omitempty"`
	IncludeReadme      bool                              `json:"includeReadme,omitempty"`
}

type DiscoveryRoot struct {
	Root            artifactstoreSpec.SourceLocator `json:"root"`
	Recursive       bool                            `json:"recursive"`
	IncludePatterns []string                        `json:"includePatterns,omitempty"`
}

type DisplayPreferences struct {
	DefaultCategory string `json:"defaultCategory,omitempty"`
}

type EmbeddedSourceAttachmentRequest struct {
	RootID              artifactstoreSpec.RootID
	DisplayName         string
	ProviderKey         string
	RootLocator         artifactstoreSpec.SourceLocator
	Role                artifactstoreSpec.AttachmentRole
	Priority            int
	AttachmentData      AttachmentData
	DiscoverImmediately bool
}

type EmptyWorkspaceRequest struct {
	DisplayName         string
	Description         string
	TrustReference      string
	Discovery           DiscoveryPreferences
	DiscoverImmediately bool
}

type FilesystemSelectionRequest struct {
	DisplayName         string
	Description         string
	RootPath            string
	FollowSymlinks      bool
	ManagedByApp        bool
	TrustReference      string
	Discovery           DiscoveryPreferences
	DiscoverImmediately bool
}

type KindDescriptor struct {
	Kind                  artifactstoreSpec.ArtifactKind
	DefinitionSchemaID    artifactstoreSpec.SchemaID
	CollectionSlug        artifactstoreSpec.CollectionSlug
	CollectionDisplayName string
}

type LoadPlan struct {
	RootID      artifactstoreSpec.RootID
	Generation  artifactstoreSpec.RootCatalogGeneration
	Items       []LoadPlanItem
	Diagnostics []artifactstoreSpec.Diagnostic
}

type LoadPlanItem struct {
	Resource   CatalogResource
	Projection Projection
	Dependency artifactstoreSpec.DependencyGraph
}

type Option func(*serviceConfig) error

type ProjectedDocument struct {
	RecordID         artifactstoreSpec.RecordID
	DefinitionDigest artifactstoreSpec.Digest
	Kind             artifactstoreSpec.ArtifactKind
	SourceID         artifactstoreSpec.SourceID
	Locator          artifactstoreSpec.SourceLocator
	Name             string
	Markdown         string
}

type ProjectedSkill struct {
	RecordID         artifactstoreSpec.RecordID
	DefinitionDigest artifactstoreSpec.Digest
	SourceID         artifactstoreSpec.SourceID
	Locator          artifactstoreSpec.SourceLocator
	Name             string
	DisplayName      string
	Description      string
	Insert           string
	Arguments        []ProjectedSkillArgument
	Markdown         string
	Frontmatter      json.RawMessage
}

type ProjectedSkillArgument struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Default     string `json:"default,omitempty"`
	Required    bool   `json:"required,omitempty"`
}

type ProjectedStructuredDefinition struct {
	RecordID         artifactstoreSpec.RecordID
	DefinitionDigest artifactstoreSpec.Digest
	Kind             artifactstoreSpec.ArtifactKind
	SourceID         artifactstoreSpec.SourceID
	Locator          artifactstoreSpec.SourceLocator
	Name             string
	Definition       json.RawMessage
}

type ProjectedWorkspaceDefinition struct {
	RecordID   artifactstoreSpec.RecordID
	Discovery  DiscoveryPreferences
	Definition json.RawMessage
}

type Projection struct {
	Kind        artifactstoreSpec.ArtifactKind
	RecordID    artifactstoreSpec.RecordID
	Value       any
	Diagnostics []artifactstoreSpec.Diagnostic
}

type ProjectionDiagnosticError struct {
	Kind        artifactstoreSpec.ArtifactKind
	Diagnostics []artifactstoreSpec.Diagnostic
}

type ProjectionInput struct {
	Workspace  Workspace
	Record     artifactstoreSpec.ArtifactRecord
	Definition artifactstoreSpec.CanonicalDefinition
}

type Reference struct {
	RecordID *artifactstoreSpec.RecordID
	Selector *artifactstoreSpec.ArtifactSelector
}

type RefreshResult struct {
	Workspace   Workspace
	Bootstrap   *artifactstoreSpec.ScanResult
	Published   artifactstoreSpec.ScanResult
	Sync        artifactstoreSpec.RecordSyncResult
	Catalog     Catalog
	Diagnostics []artifactstoreSpec.Diagnostic
}

type ResourceProjector interface {
	Kind() artifactstoreSpec.ArtifactKind
	Project(ctx context.Context, input ProjectionInput) (any, []artifactstoreSpec.Diagnostic)
}

type RootData struct {
	Mode                       RootMode                   `json:"mode"`
	PrimarySourceID            artifactstoreSpec.SourceID `json:"primarySourceID,omitempty"`
	RootTrustReference         string                     `json:"rootTrustReference,omitempty"`
	DiscoveryPreferences       DiscoveryPreferences       `json:"discoveryPreferences"`
	AttachedPackagePreferences AttachedPackagePreferences `json:"attachedPackagePreferences"`
	CapabilityProfileVersion   string                     `json:"capabilityProfileVersion"`
	DisplayPreferences         DisplayPreferences         `json:"displayPreferences"`
}

type RootMode string

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

type Workspace struct {
	Root        artifactstoreSpec.ArtifactRoot
	Data        RootData
	Attachments []artifactstoreSpec.RootSourceAttachment
}

type YAMLDecoder func(ctx context.Context, content []byte) (json.RawMessage, error)