install

type BaselineStateSource string

type ConfigKeyMigration struct {
	Key  string `json:"key"`
	From string `json:"from"`
	To   string `json:"to"`
}

type DiffPreview struct {
	Path         string
	UnifiedDiff  string
	LinesAdded   int
	LinesRemoved int
}

type GitignoreSystem interface {
	ReadFile(name string) ([]byte, error)
	WriteFileAtomic(filename string, data []byte, perm os.FileMode) error
}

type GitignoreTrackingSettings struct {
	TrackAgentLayerDir     bool
	TrackDocsAgentLayerDir bool
}

type Options struct {
	Overwrite    bool
	Prompter     *PromptFuncs // nil means no interactive prompts.
	WarnWriter   io.Writer
	PinVersion   string
	DiffMaxLines int
	System       System
}

type PromptConfigSetDefaultFunc func(key string, manifestValue any, rationale string, field *config.FieldDef) (any, error)

type PromptConfirmSkillsMigrationFunc func(flatSkills []string, conflicts []SkillsMigrationConflict) (bool, error)

type PromptDeleteUnknownAllFunc func(paths []string) (bool, error)

type PromptDeleteUnknownFunc func(path string) (bool, error)

type PromptDeleteUnknownTmpAllFunc func(paths []string) (bool, error)

type PromptFuncs struct {
	OverwriteAllUnifiedPreviewFunc PromptOverwriteAllUnifiedPreviewFunc
	OverwritePreviewFunc           PromptOverwritePreviewFunc
	StatuslineSourcePreviewFunc    PromptStatuslineSourcePreviewFunc
	DeleteUnknownAllFunc           PromptDeleteUnknownAllFunc
	DeleteUnknownFunc              PromptDeleteUnknownFunc
	DeleteUnknownTmpAllFunc        PromptDeleteUnknownTmpAllFunc
	SelectUnknownsToKeepFunc       PromptSelectUnknownsToKeepFunc
	ConfigSetDefaultFunc           PromptConfigSetDefaultFunc
	ConfirmSkillsMigrationFunc     PromptConfirmSkillsMigrationFunc
}

type PromptOverwriteAllUnifiedPreviewFunc func(managed []DiffPreview, memory []DiffPreview) (bool, bool, error)

type PromptOverwriteFunc func(path string) (bool, error)

type PromptOverwritePreviewFunc func(preview DiffPreview) (bool, error)

type PromptSelectUnknownsToKeepFunc func(paths []string) ([]string, error)

type PromptStatuslineSourcePreviewFunc func(preview DiffPreview) (bool, error)

type RealSystem struct{}

type RepairGitignoreBlockOptions struct {
	System System
}

type RollbackUpgradeSnapshotOptions struct {
	System System
}

type SkillsMigrationConflict struct {
	SkillName string
	FlatPath  string
	DirPath   string
	Reason    string
}

type StatuslineSourceTemplate struct {
	RelPath       string
	TemplatePath  string
	LegacyRelPath string
	Perm          os.FileMode
}

type System interface {
	Chmod(name string, mode os.FileMode) error
	EvalSymlinks(path string) (string, error)
	Lstat(name string) (os.FileInfo, error)
	Stat(name string) (os.FileInfo, error)
	ReadFile(name string) ([]byte, error)
	Readlink(name string) (string, error)
	LookupEnv(key string) (string, bool)
	MkdirAll(path string, perm os.FileMode) error
	RemoveAll(path string) error
	Rename(oldpath string, newpath string) error
	Symlink(oldname string, newname string) error
	WalkDir(root string, fn fs.WalkDirFunc) error
	WriteFileAtomic(filename string, data []byte, perm os.FileMode) error
}

type UpgradeChange struct {
	Path string `json:"path"`
}

type UpgradeMigrationEntry struct {
	ID              string                 `json:"id"`
	Kind            string                 `json:"kind"`
	Rationale       string                 `json:"rationale"`
	SourceAgnostic  bool                   `json:"source_agnostic"`
	Status          UpgradeMigrationStatus `json:"status"`
	SkipReason      string                 `json:"skip_reason,omitempty"`
	From            string                 `json:"from,omitempty"`
	To              string                 `json:"to,omitempty"`
	Path            string                 `json:"path,omitempty"`
	Key             string                 `json:"key,omitempty"`
	Value           json.RawMessage        `json:"value,omitempty"`
	Breaking        bool                   `json:"breaking,omitempty"`
	BreakingNotice  string                 `json:"breaking_notice,omitempty"`
	BreakingDetails []string               `json:"breaking_details,omitempty"`
}

type UpgradeMigrationReport struct {
	TargetVersion         string                       `json:"target_version,omitempty"`
	MinPriorVersion       string                       `json:"min_prior_version,omitempty"`
	ManifestPath          string                       `json:"manifest_path,omitempty"`
	SourceVersion         string                       `json:"source_version"`
	SourceVersionOrigin   UpgradeMigrationSourceOrigin `json:"source_version_origin"`
	SourceResolutionNotes []string                     `json:"source_resolution_notes,omitempty"`
	Entries               []UpgradeMigrationEntry      `json:"entries"`
}

type UpgradeMigrationSourceOrigin string

type UpgradeMigrationStatus string

type UpgradePinAction string

type UpgradePinVersionDiff struct {
	Current string           `json:"current"`
	Target  string           `json:"target"`
	Action  UpgradePinAction `json:"action"`
}

type UpgradePlan struct {
	TemplateAdditions         []UpgradeChange         `json:"template_additions"`
	TemplateUpdates           []UpgradeChange         `json:"template_updates"`
	StatuslineSourceAdditions []UpgradeChange         `json:"statusline_source_additions"`
	StatuslineSourceUpdates   []UpgradeChange         `json:"statusline_source_updates"`
	SectionAwareUpdates       []UpgradeChange         `json:"section_aware_updates"`
	TemplateRenames           []UpgradeRename         `json:"template_renames"`
	TemplateRemovalsOrOrphans []UpgradeChange         `json:"template_removals_or_orphans"`
	ConfigKeyMigrations       []ConfigKeyMigration    `json:"config_key_migrations"`
	MigrationReport           UpgradeMigrationReport  `json:"migration_report"`
	PinVersionChange          UpgradePinVersionDiff   `json:"pin_version_change"`
	ReadinessChecks           []UpgradeReadinessCheck `json:"readiness_checks"`
}

type UpgradePlanDiffPreviewOptions struct {
	System       System
	MaxDiffLines int
}

type UpgradePlanOptions struct {
	TargetPinVersion string
	System           System
}

type UpgradeReadinessCheck struct {
	ID      string   `json:"id"`
	Summary string   `json:"summary"`
	Details []string `json:"details"`
}

type UpgradeRename struct {
	From string `json:"from"`
	To   string `json:"to"`
}

type UpgradeSnapshotMetadata struct {
	ID           string
	CreatedAtUTC string
	Status       string
}