contexts

type ClientEntry struct {
	Strategy string `yaml:"strategy"`
	// Target is the absolute path gridctl wrote to.
	Target string `yaml:"target"`
	// InstalledHash is the managed-region hash exactly as written.
	InstalledHash string `yaml:"installed_hash"`
	// CanonicalHash is the canonical file's hash at sync time.
	CanonicalHash string `yaml:"canonical_hash"`
	// CreatedFile records whether gridctl created the target file itself
	// (unsync then removes the whole file, not just the managed region).
	CreatedFile bool      `yaml:"created_file"`
	SyncedAt    time.Time `yaml:"synced_at"`
}

type ClientStatus struct {
	Slug         string     `json:"slug"`
	Name         string     `json:"name"`
	Supported    bool       `json:"supported"`
	Available    bool       `json:"available"`
	Experimental bool       `json:"experimental,omitempty"`
	Strategy     string     `json:"strategy,omitempty"`
	TargetPath   string     `json:"target_path,omitempty"`
	State        string     `json:"state"`
	Detail       string     `json:"detail,omitempty"`
	SyncedAt     *time.Time `json:"synced_at,omitempty"`
}

type LockFile struct {
	Version int `yaml:"version"`
	// Scope is "global" today. Present so a future project scope can
	// share the schema without a format break.
	Scope   string                  `yaml:"scope"`
	Clients map[string]*ClientEntry `yaml:"clients"`
}

type Manager struct {
	// contains filtered or unexported fields
}

type ScanEntry struct {
	Slug   string `json:"slug"`
	Name   string `json:"name"`
	Path   string `json:"path"`
	Exists bool   `json:"exists"`
	Size   int64  `json:"size"`
}

type Strategy string

type SyncOptions struct {
	// Force overwrites drifted targets and repairs corrupt blocks.
	Force bool
	// DryRun renders and diffs without writing anything.
	DryRun bool
}

type SyncResult struct {
	Slug       string `json:"slug"`
	Name       string `json:"name"`
	Strategy   string `json:"strategy"`
	TargetPath string `json:"target_path"`
	Action     string `json:"action"`
	BackupPath string `json:"backup_path,omitempty"`
	Diff       string `json:"diff,omitempty"`
	Error      string `json:"error,omitempty"`
}

type Target struct {
	Slug     string
	Name     string
	Strategy Strategy
	// Paths is the write target per OS. A missing key means the client
	// has no known global context path on that platform.
	Paths map[string]string
	// ImportPaths is where a user's pre-existing hand-written global
	// context most likely lives, for `ctx init --import`. Defaults to
	// Paths when empty.
	ImportPaths map[string]string
	// DetectDirs mark the client as initialized on this machine when any
	// of them exists. Sync refuses to create client config trees
	// wholesale, so these gate every write.
	DetectDirs []string
	// Frontmatter is prepended verbatim to dedicated files for clients
	// whose rules format requires it (e.g. VS Code *.instructions.md).
	Frontmatter string
	// MaxChars caps the rendered target file size; 0 means unlimited.
	// Windsurf enforces a 6,000-character limit on global_rules.md.
	MaxChars int
	// Experimental marks targets whose documented path rests on
	// unofficial sourcing; surfaced in status output.
	Experimental bool
}

type UnsupportedClient struct {
	Slug   string
	Name   string
	Reason string
}

type UnsyncResult struct {
	Slug       string `json:"slug"`
	TargetPath string `json:"target_path"`
	// Action is "removed-file", "removed-region", or "already-gone".
	Action string `json:"action"`
}