state

type FileEntry struct {
	// Source is the absolute path in the layer.
	Source string `json:"source" yaml:"source"`

	// Project this file belongs to.
	Project string `json:"project" yaml:"project"`

	// Layer is the repository layer this file came from (base, team, personal).
	// Empty for single-repo deployments.
	Layer string `json:"layer,omitempty" yaml:"layer,omitempty"`

	// Operations performed: link, expand, copy, decrypt.
	Operations []string `json:"operations" yaml:"operations"`

	// DeployedAt is when the file was deployed.
	DeployedAt time.Time `json:"deployed_at" yaml:"deployed_at"`

	// Receipt is the receipt filename that recorded this deployment.
	Receipt string `json:"receipt" yaml:"receipt"`

	// SourceChecksum is the SHA256 of the source file at deploy time.
	// Only set for copied files (expand, decrypt, copy operations).
	SourceChecksum string `json:"source_checksum,omitempty" yaml:"source_checksum,omitempty"`

	// TargetChecksum is the SHA256 of the target file after deployment.
	// Only set for copied files (expand, decrypt, copy operations).
	TargetChecksum string `json:"target_checksum,omitempty" yaml:"target_checksum,omitempty"`
}

type State struct {
	// Version is the state file format version.
	Version string `json:"version" yaml:"version"`

	// LastUpdated is when the state was last modified.
	LastUpdated time.Time `json:"last_updated" yaml:"last_updated"`

	// SourceRoot is the environment layer path.
	// For multi-layer deployments, this is the first layer's path.
	SourceRoot string `json:"source_root" yaml:"source_root"`

	// TargetRoot is the deployment target (e.g., $HOME).
	TargetRoot string `json:"target_root" yaml:"target_root"`

	// Layers lists the repository layers used in the deployment.
	// Empty for single-repo deployments.
	Layers []string `json:"layers,omitempty" yaml:"layers,omitempty"`

	// Files maps relative target paths to their deployment info.
	Files map[string]*FileEntry `json:"files" yaml:"files"`

	// Signature contains the cryptographic signature (optional).
	Signature *receipt.Signature `json:"signature,omitempty" yaml:"signature,omitempty"`
}