agentsync

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

type AdoptResult struct {
	Agent  string `json:"agent"`
	Client string `json:"client"`
	// Target is the projected file the content came from.
	Target string `json:"target"`
	// CanonicalFile is the canonical AGENT.md written into.
	CanonicalFile string `json:"canonical_file"`
	// BackupFile is the AGENT.md.pre-<sha> backup written store-side
	// before the overwrite (empty when the content did not change).
	BackupFile string `json:"backup_file,omitempty"`
	// Changed reports whether the projected content differed from canon.
	Changed bool `json:"changed"`
	// PolicyKeysRestored reports that the projected file carried a stack
	// model preference rewrite whose keys were restored to the author's
	// declaration before write-back: policy-owned deltas are never
	// adopted into the canonical store.
	PolicyKeysRestored bool `json:"policy_keys_restored,omitempty"`
}

type Entry struct {
	// Target is the absolute file path gridctl wrote.
	Target string
	// InstalledHash is the projected file's hash exactly as written.
	InstalledHash string
	// CanonicalHash is the canonical AGENT.md hash at sync time. The
	// render is identity, so the two coincide at write time; they diverge
	// when either side changes.
	CanonicalHash string
	// CreatedByGridctl marks the path as gridctl-owned. Always true for
	// recorded entries.
	CreatedByGridctl bool
	// ModelValue is the model preference a policy rewrite wrote into the
	// installed bytes; non-empty marks the projection as rewritten (the
	// preserve rule and adopt key on it), and the value lets adopt tell
	// the policy's write apart from a deliberate user edit. Empty for
	// pass-through projections.
	ModelValue string
	// Pack tags the projection with the pack that applied it (empty =
	// not pack-managed).
	Pack     string
	SyncedAt time.Time
}

type LockFile struct {
	// Projections maps agent name → client slug → entry.
	Projections map[string]map[string]*Entry
}

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

type ProjectionStatus struct {
	Agent   string `json:"agent"`
	Client  string `json:"client"`
	Channel string `json:"channel"`
	Target  string `json:"target"`
	// Render is the target's render class: "identity" (canonical bytes
	// copied verbatim) or "lossy" (client dialect, some keys dropped).
	Render string `json:"render"`
	// ModelValue is the model preference a policy rewrite wrote into the
	// installed bytes; empty for pass-through projections.
	ModelValue string `json:"model_value,omitempty"`
	State      string `json:"state"`
	Detail     string `json:"detail,omitempty"`
	// Pack names the pack that applied this projection; empty for
	// projections made outside a pack. Additive provenance for UI chips.
	Pack     string     `json:"pack,omitempty"`
	SyncedAt *time.Time `json:"synced_at,omitempty"`
}

type RenderFunc func(def *skills.AgentDefinition) (Rendered, error)

type Rendered struct {
	Bytes   []byte
	Dropped []string
}

type SyncOptions struct {
	// Clients restricts the pass to these target slugs. Empty means every
	// available target.
	Clients []string
	// Force overwrites drifted copies and unmanaged destination files
	// (after a timestamped backup).
	Force bool
	// DryRun reports the plan without writing anything.
	DryRun bool
	// Pack tags recorded projections with the applying pack. Empty keeps
	// any existing tag (a plain re-sync never strips pack ownership).
	Pack string
}

type SyncResult struct {
	Agent   string `json:"agent"`
	Client  string `json:"client"`
	Channel string `json:"channel,omitempty"`
	Target  string `json:"target,omitempty"`
	Action  string `json:"action"`
	// Detail carries the lossy-render report (which canonical keys the
	// target dialect dropped); empty for identity targets.
	Detail     string `json:"detail,omitempty"`
	BackupPath string `json:"backup_path,omitempty"`
	Error      string `json:"error,omitempty"`
}

type Target struct {
	Slug string
	Name string
	// AgentsPath is a ~-template expanded against the Manager's home.
	AgentsPath string
	// DetectDirs mark the client as initialized on this machine. The
	// agents directory itself is created on first sync, but only inside
	// a detected client tree.
	DetectDirs []string
	// Render converts the canonical definition into the client dialect.
	// Nil means identity: the canonical bytes are copied verbatim.
	Render RenderFunc
	// FileName maps an agent name to the target's file name. Nil means
	// "<name>.md" (Copilot requires "<name>.agent.md").
	FileName func(name string) string
}

type UnsyncOptions struct {
	// All removes every projection instead of named agents.
	All bool
	// Clients restricts removal to these target slugs.
	Clients []string
	// DryRun reports what would be removed without writing.
	DryRun bool
}

type UnsyncResult struct {
	Agent      string `json:"agent"`
	Client     string `json:"client"`
	Target     string `json:"target"`
	Action     string `json:"action"`
	BackupPath string `json:"backup_path,omitempty"`
}