layout

type CleanAction struct {
	Path       string `json:"path" yaml:"path"`
	OriginSlug string `json:"origin_slug,omitempty" yaml:"origin_slug,omitempty"`
	Status     string `json:"status" yaml:"status"` // removed, planned, skipped, error
	Reason     string `json:"reason" yaml:"reason"`
}

type CleanOptions struct {
	Apply                 bool
	AllowMissingCanonical bool
}

type CleanReport struct {
	SchemaVersion int           `json:"schema_version" yaml:"schema_version"`
	ProjectsRoot  string        `json:"projects_root" yaml:"projects_root"`
	DryRun        bool          `json:"dry_run" yaml:"dry_run"`
	Actions       []CleanAction `json:"actions" yaml:"actions"`
}

type Finding struct {
	Path         string `json:"path" yaml:"path"`
	Kind         Kind   `json:"kind" yaml:"kind"`
	PathSlug     string `json:"path_slug,omitempty" yaml:"path_slug,omitempty"`
	OriginSlug   string `json:"origin_slug,omitempty" yaml:"origin_slug,omitempty"`
	ExpectedPath string `json:"expected_path,omitempty" yaml:"expected_path,omitempty"`
	// RemoteURL is the remote URL the clone's canonical path corresponds to. A
	// clone that already sits at <root>/{host}/{owner}/{repository} inverts to
	// it by pure path arithmetic — no configuration and no repository remote
	// is read — and a legacy two-level clone reports the host its origin
	// already names, which is the host level it must move under.
	RemoteURL       string `json:"remote_url,omitempty" yaml:"remote_url,omitempty"`
	CanonicalExists bool   `json:"canonical_exists,omitempty" yaml:"canonical_exists,omitempty"`
	Reason          string `json:"reason" yaml:"reason"`
}

type Kind string

type MigrateClone struct {
	Repository  string            `json:"repository"`
	Source      string            `json:"source"`
	Destination string            `json:"destination"`
	Worktrees   []MigrateWorktree `json:"worktrees,omitempty"`
	// Status is one of: planned, done, already_done, needs_repair, repaired,
	// skipped, failed, reversed. needs_repair is a dry-run-only finding: a
	// clone already at its host-level path whose worktree registration was
	// left stranded by an earlier or partial move; like planned, it is not a
	// failure — it names what `--apply` will fix.
	Status string `json:"status"`
	Reason string `json:"reason,omitempty"`
	// Head is the clone's own HEAD at plan time, carried through to the
	// undo manifest. It is not part of the report's public JSON shape.
	Head string `json:"-"`
}

type MigrateKeptOwner struct {
	Path   string `json:"path"`
	Reason string `json:"reason"`
}

type MigrateOptions struct {
	// Repositories restricts migration to these owner/repository slugs. Empty
	// means every legacy clone under the root.
	Repositories []string
	// Apply moves clones; without it the command only plans.
	Apply bool
	// UndoID reverses a previously completed manifest instead of migrating.
	UndoID string
	Now    func() time.Time
}

type MigrateReport struct {
	SchemaVersion         int            `json:"schema_version"`
	ProjectsRoot          string         `json:"projects_root"`
	ObservedAt            time.Time      `json:"observed_at"`
	DryRun                bool           `json:"dry_run"`
	Undo                  bool           `json:"undo,omitempty"`
	ManifestID            string         `json:"manifest_id,omitempty"`
	ManifestPath          string         `json:"manifest_path,omitempty"`
	DaemonRestartRequired bool           `json:"daemon_restart_required,omitempty"`
	Clones                []MigrateClone `json:"clones"`
	// KeptOwners lists every legacy owner directory a migration left in
	// place because it still holds something, with why.
	KeptOwners []MigrateKeptOwner `json:"kept_owners,omitempty"`
	// Notes carries run-level observations that are not per-clone, such as
	// the busy-process check being unsupported on this OS.
	Notes []string `json:"notes,omitempty"`
}

type MigrateWorktree struct {
	Source      string `json:"source"`
	Destination string `json:"destination"`
}

type Report struct {
	SchemaVersion int       `json:"schema_version" yaml:"schema_version"`
	ProjectsRoot  string    `json:"projects_root" yaml:"projects_root"`
	ObservedAt    time.Time `json:"observed_at" yaml:"observed_at"`
	Summary       Summary   `json:"summary" yaml:"summary"`
	Findings      []Finding `json:"findings" yaml:"findings"`
}

type Summary struct {
	Inspected  int `json:"inspected" yaml:"inspected"`
	OK         int `json:"ok" yaml:"ok"`
	TopLevel   int `json:"top_level" yaml:"top_level"`
	Misowned   int `json:"misowned" yaml:"misowned"`
	NoOrigin   int `json:"no_origin" yaml:"no_origin"`
	Unreadable int `json:"unreadable" yaml:"unreadable"`
	BadHost    int `json:"bad_host" yaml:"bad_host"`
}