sync

type BudgetWarningMsg struct {
	Agent   string
	Message string
}

type CommandExecutor interface {
	Execute(ctx context.Context, command string, timeout time.Duration) (stdout, stderr string, err error)
}

type GitHubFetcher interface {
	FetchFile(ctx context.Context, owner, repo, path, ref string) ([]byte, error)
	FetchDirectory(ctx context.Context, owner, repo, dirPath, ref string) ([]SkillFile, error)
	LatestCommitSHA(ctx context.Context, owner, repo, branch string) (string, error)
	GetTree(ctx context.Context, owner, repo, ref string) ([]provider.TreeEntry, error)
}

type Kind string

type LegacyFormatMsg struct{ Repo string }

type LockMismatchError struct {
	Registry string        `json:"registry"`
	Refused  []LockRefusal `json:"refused"`
}

type LockRefusal struct {
	Name         string `json:"name"`
	ExpectedHash string `json:"expected_hash"`
	ActualHash   string `json:"actual_hash"`
	Reason       string `json:"reason"`
}

type MergeConflictMsg struct {
	Name string
}

type MergeResult int

type ModifiedStrategy int

type NameConflict struct {
	Name string
	Tool string
	Path string
}

type NameConflictAction string

type NameConflictError struct {
	Conflict   NameConflict
	Resolution NameConflictResolution
	Err        error
}

type NameConflictResolution struct {
	Action NameConflictAction `json:"action"`
	Alias  string             `json:"alias,omitempty"`
}

type NameConflictResolvedMsg struct {
	Conflict   NameConflict
	Resolution NameConflictResolution
}

type NoopFetcher struct{}

type PackageApprovedMsg struct{ Name string }

type PackageDeniedMsg struct{ Name string }

type PackageDetectedMsg struct {
	Name   string
	Dir    string
	Source string // where the install command came from (scribe.yaml, ./setup, …)
}

type PackageErrorMsg struct {
	Name   string
	Err    error
	Stderr string
}

type PackageHashMismatchMsg struct {
	Name       string
	OldCommand string
	NewCommand string
	Source     string
}

type PackageInstallPlan struct {
	// Command is the shell command to run after writing the package dir.
	// Executed from within the package directory.
	Command string
	// Uninstall, if set, is the command to run when `scribe remove <name>`
	// is invoked for this package. Best-effort.
	Uninstall string
	// Source is a short description of where the command came from
	// ("scribe.yaml", "./setup", "install.sh", "package.json", "Makefile").
	Source string
}

type PackageInstallPromptMsg struct {
	Name    string
	Command string
	Source  string
}

type PackageInstalledMsg struct{ Name string }

type PackageInstallingMsg struct{ Name string }

type PackageOutputMsg struct {
	Name   string
	Stdout string
	Stderr string
}

type PackageReclassifiedMsg struct {
	Name        string
	OldPath     string
	NewPath     string
	InstallHint string
}

type PackageSkippedMsg struct {
	Name   string
	Reason string
}

type PackageUpdateMsg struct{ Name string }

type PackageUpdatedMsg struct{ Name string }

type ProjectLockError struct {
	Refused []LockRefusal `json:"refused"`
}

type ReconcileCompleteMsg struct {
	Summary reconcile.Summary
}

type ReconcileConflictMsg struct {
	Name     string
	Conflict state.ProjectionConflict
}

type ShellExecutor struct{}

type SkillAdoptionNeededMsg struct {
	Name string
	Tool string
	Path string
}

type SkillDownloadingMsg struct{ Name string }

type SkillErrorMsg struct {
	Name string
	Err  error
}

type SkillFile = tools.SkillFile

type SkillInstalledMsg struct {
	Name     string
	Updated  bool // true = update, false = fresh install
	Merged   bool // true if 3-way merge was used
	Revision int  // post-install revision number (1 for fresh install)
}

type SkillResolvedMsg struct{ SkillStatus }

type SkillSkippedByDenyListMsg struct {
	Name     string
	Registry string
}

type SkillSkippedMsg struct{ Name string }

type SkillStatus struct {
	Name       string
	Status     Status
	Installed  *state.InstalledSkill // nil if not installed
	Entry      *manifest.Entry       // catalog entry, nil for StatusExtra
	LoadoutRef string                // the ref from the manifest (e.g. "v1.0.0", "main")
	Maintainer string
	IsPackage  bool
	LatestSHA  string // resolved SHA for branch-pinned skills; empty if unavailable
	BlobSHAs   map[string]string
	LockEntry  *lockfile.Entry

	SourceKey   string
	Source      *source.SourceSpec
	ResolvedRev string
}

type Status int

type StatusDisplay struct {
	Icon  string
	Label string
}

type SyncCompleteMsg struct {
	Installed int
	Updated   int
	Skipped   int
	Failed    int
}

type Syncer struct {
	Client   GitHubFetcher
	Provider provider.Provider // optional — if set, used for discovery and fetch
	Tools    []tools.Tool
	Emit     func(any) // receives events defined in events.go
	Executor CommandExecutor
	// ProjectRoot scopes tool projections to a project-local agent directory.
	// Empty preserves legacy global projections.
	ProjectRoot string

	// ModifiedStrategy controls what to do when an outdated skill also has
	// unsynced local edits on disk.
	ModifiedStrategy ModifiedStrategy

	// SkillFilter, if non-nil, restricts the sync to only the named skills.
	// Skills not in the list are skipped entirely (not even resolved/emitted).
	// Used by `scribe install` to install specific skills.
	SkillFilter []string

	// KitFilter, if non-nil, restricts symlink emission to skills resolved by
	// the project's kit set. Empty/nil means no kit filtering (legacy behavior).
	// Computed from the project file by StepResolveKitFilter so `scribe sync`
	// matches `scribe show` output.
	KitFilter        []string
	KitFilterEnabled bool

	// SkipMissing prevents installing skills that are not yet locally installed.
	// When true, StatusMissing skills are silently skipped — only updates and
	// removals are processed. Set by `scribe sync` to implement the opt-in
	// model: new skills from a registry are not auto-installed; the user must
	// explicitly run `scribe add <skill>` or `scribe install` to install them.
	SkipMissing bool

	// TrustAll skips approval prompts for packages (--trust-all flag).
	TrustAll bool

	// ForceBudget allows projection even when an agent description-byte budget
	// would otherwise be exceeded.
	ForceBudget bool

	// ApprovalFunc is called when a package needs interactive approval.
	// Returns true if approved, false if denied.
	// If nil and TrustAll is false, packages needing approval are skipped.
	ApprovalFunc func(name, command, source string) bool

	// AliasName installs an incoming skill under this alternate name when a
	// real directory already exists at the original tool projection path.
	AliasName string

	// SkillAliases installs named incoming skills under fixed local names.
	// Used by registry kits to avoid same-name collisions across sources.
	SkillAliases map[string]string

	// PinnedSkillSources overrides catalog source refs for named skills during
	// kit dependency installs.
	PinnedSkillSources map[string]string

	// OnRegistryFetched runs after a registry manifest has been fetched and
	// applied successfully. Callers use this for local metadata caches.
	OnRegistryFetched func(repo string, m *manifest.Manifest) error

	// NameConflictResolver is called when a real directory already exists at
	// the incoming skill name. Nil means non-interactive conflict.
	NameConflictResolver func(NameConflict) (NameConflictResolution, error)
}

type TreeEntry = provider.TreeEntry

type VersionInfo struct {
	Revision int
	Path     string
	ModTime  time.Time
}