registry

type FileOperationFilter struct {
	ToolName      string
	OperationType string
	FileType      string
	FilePath      string
	CreatedAfter  int64
	CreatedBefore int64
	OperationID   string
	// BlockID restricts the result to operations owning one managed block. A file
	// can hold blocks belonging to several tools, so filtering by path alone would
	// mix their histories together.
	BlockID string
}

type FileOperationRecord struct {
	ID            int64       `db:"id"`
	ToolName      string      `db:"tool_name"`
	OperationType string      `db:"operation_type"` // e.g., "symlink", "shim", "write"
	FilePath      string      `db:"file_path"`
	TargetPath    *string     `db:"target_path"`
	FileType      string      `db:"file_type"`
	Metadata      *string     `db:"metadata"`
	SizeBytes     *int64      `db:"size_bytes"`
	Permissions   *Permission `db:"permissions" json:"permissions"`
	CreatedAt     int64       `db:"created_at"` // Unix millisecond epoch
	OperationID   string      `db:"operation_id"`
	// ContentHash is the SHA-256 of exactly what dotfiles wrote, and is the base
	// version a later run measures the file on disk against. It is nil for an
	// operation that writes no content of its own, such as a symlink or a chmod.
	ContentHash *string `db:"content_hash" json:"contentHash,omitempty"`
	// BlockID names the managed block this operation owns within a shared file. It
	// is nil when the operation owns the whole file.
	BlockID *string `db:"block_id" json:"blockId,omitempty"`
	// TargetMode is the permission the tool declared, as opposed to Permissions,
	// which is the mode the file was actually written with. Comparing the two is how
	// a mode that has drifted away from its declaration is noticed.
	TargetMode *Permission `db:"target_mode" json:"targetMode,omitempty"`
}

type FileState struct {
	FilePath      string      `json:"filePath"`
	ToolName      string      `json:"toolName"`
	FileType      string      `json:"fileType"`
	LastOperation string      `json:"lastOperation"`
	TargetPath    *string     `json:"targetPath"`
	LastModified  int64       `json:"lastModified"`
	Metadata      *string     `json:"metadata"`
	SizeBytes     *int64      `json:"sizeBytes"`
	Permissions   *Permission `json:"permissions" db:"permissions"`
	ContentHash   *string     `json:"contentHash"`
	BlockID       *string     `json:"blockId"`
	TargetMode    *Permission `json:"targetMode"`
}

type Permission string

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

type ToolInstallationRecord struct {
	ID                int64   `db:"id"`
	ToolName          string  `db:"tool_name"`
	Version           string  `db:"version"`
	InstallPath       string  `db:"install_path"`
	Timestamp         string  `db:"timestamp"`
	InstalledAt       int64   `db:"installed_at"` // Unix millisecond epoch
	BinaryPaths       string  `db:"binary_paths"` // JSON array string
	DownloadURL       *string `db:"download_url"`
	AssetName         *string `db:"asset_name"`
	ConfiguredVersion *string `db:"configured_version"`
	OriginalTag       *string `db:"original_tag"`
	InstallMethod     *string `db:"install_method"`
}

type ToolInstallationUpdate struct {
	Version           *string
	InstallPath       *string
	Timestamp         *string
	BinaryPaths       *string
	DownloadURL       *string
	AssetName         *string
	ConfiguredVersion *string
	OriginalTag       *string
	InstallMethod     *string
}

type ToolUsageRecord struct {
	ToolName   string `db:"tool_name" json:"toolName"`
	BinaryName string `db:"binary_name" json:"binaryName"`
	UsageCount int    `db:"usage_count" json:"usageCount"`
	LastUsedAt int64  `db:"last_used_at" json:"lastUsedAt"`
}

type ValidationResult struct {
	Valid    bool     `json:"valid"`
	Issues   []string `json:"issues"`
	Repaired []string `json:"repaired"`
}