framework

type AlreadyInstalledError struct {
	Path string
}

type ApeInfo struct {
	Version string `json:"version" yaml:"version"`
}

type BootstrapValues struct {
	ProjectName string
	Extensions  []string // canonical IDs; e.g., {"ext-adrs", "ext-features"}
}

type Bootstrapper interface {
	Bootstrap(ctx context.Context, defaultProjectName string, extensions []Extension) (BootstrapValues, error)
}

type ConfigLocalExampleSource struct {
	Seeded bool `json:"seeded" yaml:"seeded"`
}

type ConfigSource struct {
	Seeded      bool     `json:"seeded"                yaml:"seeded"`
	ProjectName string   `json:"projectName,omitempty" yaml:"project_name,omitempty"`
	Extensions  []string `json:"extensions,omitempty"  yaml:"extensions,omitempty"`
}

type Drift struct {
	HashDrift bool     `json:"hashDrift"       yaml:"hashDrift"`
	TagDrift  bool     `json:"tagDrift"        yaml:"tagDrift"`
	Notes     []string `json:"notes,omitempty" yaml:"notes,omitempty"`
}

type Extension struct {
	ID          string
	Description string
}

type Metadata struct {
	ConfigSchemaVersion string    `json:"configSchemaVersion" yaml:"config_schema_version"`
	InstalledAt         time.Time `json:"installedAt"         yaml:"installed_at"`
	Framework           RepoInfo  `json:"framework"           yaml:"framework"`
	Ape                 ApeInfo   `json:"ape"                 yaml:"ape"`
	Sources             Sources   `json:"sources"             yaml:"sources"`
}

type NoopBootstrapper struct{}

type NotInstalledError struct {
	Path string
}

type PipelinesSource struct {
	Count int      `json:"count" yaml:"count"`
	Paths []string `json:"paths" yaml:"paths"`
}

type PorcelainEntry struct {
	Status string // 2-char status code, e.g. " M", "M ", "??", "A "
	Path   string
}

type ProjectSkillsModifiedError struct {
	Paths []string
}

type RepoInfo struct {
	RepoOrigin string `json:"repoOrigin" yaml:"repo_origin"`
	VersionTag string `json:"versionTag" yaml:"version_tag"` // empty when HEAD has no exact tag
	GitHash    string `json:"gitHash"    yaml:"git_hash"`
	GitBranch  string `json:"gitBranch"  yaml:"git_branch"`
}

type SkillScope string

type SkillsSource struct {
	Count int      `json:"count" yaml:"count"`
	Paths []string `json:"paths" yaml:"paths"`
}

type Sources struct {
	Skills             SkillsSource             `json:"skills"             yaml:"skills"`
	Pipelines          PipelinesSource          `json:"pipelines"          yaml:"pipelines"`
	Config             ConfigSource             `json:"config"             yaml:"config"`
	ConfigLocalExample ConfigLocalExampleSource `json:"configLocalExample" yaml:"config_local_example"`
}

type StaticBootstrapper struct {
	Values BootstrapValues
}

type StatusOptions struct {
	ProjectRoot   string
	FrameworkRepo string // optional; when set, drift fields are populated
	NoFetch       bool   // skip fetch when reading framework HEAD
}

type StatusResult struct {
	Installed Metadata  `json:"installed"         yaml:"installed"`
	Current   *RepoInfo `json:"current,omitempty" yaml:"current,omitempty"`
	Drift     *Drift    `json:"drift,omitempty"   yaml:"drift,omitempty"`
}

type TUIBootstrapper struct{}

type UpdateOptions struct {
	// FrameworkRepo is the absolute path to a checked-out
	// apex_process_framework repo.
	FrameworkRepo string
	// ProjectRoot is the absolute path to the project the install
	// targets.
	ProjectRoot string
	// NoFetch skips the `git fetch && merge --ff-only` step.
	NoFetch bool
	// Force bypasses the framework-clean / project-skills-modified
	// safety checks. Use sparingly.
	Force bool
	// ApeVersion is the version string of the binary performing the
	// install. Recorded into framework.yaml's `ape.version`.
	ApeVersion string
	// Bootstrapper resolves config-bootstrap values when
	// _apex/config.yaml is absent. Required.
	Bootstrapper Bootstrapper
	// Now is injectable for deterministic tests; defaults to
	// time.Now().UTC().
	Now func() time.Time
}

type UpdateResult struct {
	Metadata Metadata
	Summary  UpdateSummary
}

type UpdateSummary struct {
	SkillsInstalled    int      `json:"skillsInstalled"              yaml:"skillsInstalled"`
	SkillsRemoved      int      `json:"skillsRemoved"                yaml:"skillsRemoved"`
	SkillsRemovedPaths []string `json:"skillsRemovedPaths,omitempty" yaml:"skillsRemovedPaths,omitempty"`
	PipelinesInstalled int      `json:"pipelinesInstalled"           yaml:"pipelinesInstalled"`
	ConfigSeeded       bool     `json:"configSeeded"                 yaml:"configSeeded"`
	ConfigLocalSeeded  bool     `json:"configLocalSeeded"            yaml:"configLocalSeeded"`
}

type ValidationError struct {
	Code   string // e.g. "framework_dirty", "framework_not_main"
	Detail string
}