lockfile

type ComponentLock struct {
	// Version is the lock file format version.
	Version int `toml:"version" comment:"Managed by azldev component update. Do not edit manually."`

	// ImportCommit is the upstream commit hash at the time of initial import
	// (fork point). Upstream changelog up to this commit is inherited verbatim.
	// Write-once: set on first import, never changed afterwards.
	// Empty for local components.
	ImportCommit string `toml:"import-commit,omitempty"`

	// UpstreamCommit is the current resolved upstream commit hash.
	// Updated by 'component update' when upstream sources are re-resolved.
	// Empty for local components.
	UpstreamCommit string `toml:"upstream-commit,omitempty"`

	// ManualBump is an extra rebuild counter for mass-rebuild scenarios.
	// Almost always 0. Incrementing this changes the component's fingerprint,
	// triggering a new release without any other input change.
	ManualBump int `toml:"manual-bump,omitempty"`

	// InputFingerprint is the hash of all render inputs (config, overlays,
	// upstream-commit, manual-bump, distro release version). Recomputed on
	// every update. Used to detect when inputs have changed.
	InputFingerprint string `toml:"input-fingerprint,omitempty"`

	// ResolutionInputHash is a hash of the config inputs that affect upstream
	// commit resolution (snapshot timestamp, distro reference, explicit pin).
	// Used for staleness detection: if the current config's resolution inputs
	// produce a different hash than what's stored, the locked upstream commit
	// may no longer be correct and 'component update' will re-resolve it.
	//
	// This enables a fast check without re-resolving upstream commits:
	//   - Hash matches → resolution inputs unchanged, reuse locked commit
	//   - Hash differs → resolution inputs changed, re-resolve required
	ResolutionInputHash string `toml:"resolution-input-hash,omitempty"`
}

type LockReader interface {
	// Get returns the lock for a component. Returns an error if the lock file
	// does not exist or cannot be parsed.
	Get(componentName string) (*ComponentLock, error)
	// Exists checks whether a lock file exists for the given component.
	Exists(componentName string) (bool, error)
	// LockDir returns the absolute path to the lock file directory.
	LockDir() string
	// ValidateConsistency checks lock files against the resolved component
	// configs. Returns sorted lists of components with missing/stale locks
	// and orphan component names.
	ValidateConsistency(
		components map[string]projectconfig.ComponentConfig,
		checkOrphans bool,
	) (missingOrStale, orphans []string, err error)
}

type LockWriter interface {
	LockReader
	// GetOrNew returns the lock for a component, creating a new empty lock if
	// none exists on disk. Returns an error if the lock file exists but is
	// corrupt/unreadable.
	GetOrNew(componentName string) (*ComponentLock, error)
	// Save writes the lock for a component to disk.
	Save(componentName string, lock *ComponentLock) error
	// Remove deletes a component's lock file from disk.
	Remove(componentName string) error
}

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