project

type AddOptions struct {
	// ProjectPath is the project root. May be relative or contain a `~`;
	// Add resolves to an absolute, symlink-evaluated canonical path
	// before doing anything else. Empty string means "use cwd".
	ProjectPath string

	// Dirs scopes which agent dirs to add. Empty slice (the default)
	// means "all detected agent dirs at the project root"; a non-empty
	// slice restricts the run to the named dirs. Names that don't exist
	// at the project root surface as CodeNotFound; names already tracked
	// for this project are reported as AlreadyTracked rather than added
	// again (extending a tracked project is supported via a fresh
	// `--dir` invocation).
	Dirs []string

	// Name overrides the project name lore records (and uses to key
	// central/projects/<name>/). Empty means "use filepath.Base of the
	// resolved project path". Useful when two projects share a basename
	// in different parents, or when the user wants a different label in
	// central than the on-disk directory name.
	Name string

	// Create asks Add to scaffold an agent dir at the project root when
	// none would otherwise be found. With --dir, each named dir that
	// doesn't already exist is scaffolded (silent default filename). Without
	// --dir, an interactive picker collects a (dir, file) pair. Existing
	// dirs are left untouched (idempotent skip). Non-TTY without --dir is
	// CodeInconsistency.
	Create bool
}

type AddResult struct {
	ProjectName   string
	ProjectPath   string // resolved, absolute
	CentralRepo   string // central repo root (for the Next hint)
	CommitMessage string // empty when nothing was newly added
	CommitSHA     string // full central commit SHA used as the sync-base
	SyncBase      string // checkout sync-base after this operation
	Dirs          []AgentDirResult
	// ScaffoldRequested is true when the user passed --create. Carried
	// even when no scaffolding actually happened (all targets already
	// existed) so JSON consumers can distinguish "user asked for
	// create" from "lore decided to create".
	ScaffoldRequested bool
}

type AgentDirResult struct {
	Name        string
	Status      DirStatus
	CentralPath string             // populated for StatusAdded, StatusAlreadyTracked, StatusScaffolded
	Violations  []detect.Violation // populated for StatusSkippedSafety
}

type CheckoutStatus struct {
	Path      string
	SyncBase  string
	State     reconcile.SyncState
	BaseStale bool
	Dirs      []DirSyncStatus
	Issues    []reconcile.Issue
}

type DirStatus string

type DirSyncStatus struct {
	Name      string
	State     reconcile.SyncState
	BaseStale bool
	Files     []reconcile.FileResult
	Issues    []reconcile.Issue
}

type DoctorResult struct {
	Status  StatusResult
	Fixed   []string
	Healthy bool
}

type ListResult struct {
	CentralRepo string
	CentralHead string
	Rows        []ListRow
}

type ListRow struct {
	Name      string
	Path      string
	AgentDirs []string
	State     string
	Issues    []reconcile.Issue
}

type MoveCheckoutResult struct {
	OldPath  string
	Path     string
	SyncBase string
}

type MoveResult struct {
	OldName       string
	ProjectName   string
	CentralRepo   string
	CommitMessage string
	Commit        string
	Checkouts     []MoveCheckoutResult
	CentralOnly   bool
}

type ProjectStatus struct {
	Name      string
	Checkouts []CheckoutStatus
	Issues    []reconcile.Issue
}

type PullCheckoutResult struct {
	Path     string
	Status   PullCheckoutStatus
	SyncBase string
	Dirs     []PullDirResult
	Err      error
}

type PullCheckoutStatus string

type PullConflictResult struct {
	Path        string
	Kind        reconcile.ConflictKind
	SiblingPath string
}

type PullDirResult struct {
	Name      string
	Path      string
	Status    PullDirStatus
	Unignored bool
	Conflicts []PullConflictResult
}

type PullDirStatus string

type PullOptions struct {
	Name    string
	Path    string
	All     bool
	Central bool
	Project bool
}

type PullProjectResult struct {
	Name      string
	Status    PullProjectStatus
	Matches   []string
	Checkouts []PullCheckoutResult
	Err       error
}

type PullProjectStatus string

type PullResult struct {
	CentralRepo  string
	CentralHead  string
	ScannedRoots []string
	Projects     []PullProjectResult
}

type PushCheckoutResult struct {
	Path   string
	Status PushStatus
}

type PushOptions struct {
	Project        string
	ProjectFromCWD bool
}

type PushProjectResult struct {
	Name      string
	Checkouts []PushCheckoutResult
}

type PushResult struct {
	CentralRepo   string
	PreviousHead  string
	CommitSHA     string
	CommitMessage string
	Projects      []PushProjectResult
	ScopeProject  string
}

type PushStatus string

type RmCopyResult struct {
	Checkout string
	Dir      string
	Path     string
	State    reconcile.SyncState
	Issues   []reconcile.Issue
	Status   RmCopyStatus
}

type RmCopyStatus string

type RmPlan struct {
	ProjectName string
	CentralRepo string
	CommitMsg   string
	RecoveryCmd string
	Purge       bool
	Copies      []RmCopyResult
	RefusalErr  error
	Force       bool
	// contains filtered or unexported fields
}

type RmResult struct {
	ProjectName   string
	CentralRepo   string
	CommitMessage string
	Commit        string
	RecoveryCmd   string
	Purge         bool
	Copies        []RmCopyResult
}

type StatusResult struct {
	CentralRepo string
	CentralHead string
	Projects    []ProjectStatus
}