pack

type PackManifest struct {
	// Name is the pack identifier.
	Name string `json:"name"`

	// Version is the pack version.
	Version string `json:"version"`

	// Description is a human-readable description.
	Description string `json:"description,omitempty"`

	// Skills lists the skill names in this pack.
	Skills []string `json:"skills"`

	// Author is the pack author.
	Author string `json:"author,omitempty"`

	// License is the pack license.
	License string `json:"license,omitempty"`

	// Repository is the source repository URL.
	Repository string `json:"repository,omitempty"`

	// Homepage is the pack homepage URL.
	Homepage string `json:"homepage,omitempty"`

	// Keywords are searchable keywords.
	Keywords []string `json:"keywords,omitempty"`

	// CreatedAt is when the pack was created.
	CreatedAt time.Time `json:"created_at"`
}

type PublishBundle struct {
	// Manifest contains pack metadata.
	Manifest *PackManifest

	// BundlePath is the path to the tarball.
	BundlePath string

	// Checksum is the SHA256 of the bundle.
	Checksum string

	// Size is the bundle size in bytes.
	Size int64

	// Validation is the validation result.
	Validation *ValidationResult
}

type PublishConfig struct {
	// SkillsDir is the directory containing skills to publish.
	SkillsDir string

	// PackName is the name of the skill pack.
	PackName string

	// Version is the pack version (defaults to git commit).
	Version string

	// OutputDir is where to write the publish bundle.
	OutputDir string

	// Strict treats validation warnings as errors.
	Strict bool
}

type ScaffoldConfig struct {
	// SkillsDir is the directory containing skills to pack.
	SkillsDir string

	// PackageName is the Go package name for the generated pack.
	PackageName string

	// PackName is the name of the skill pack.
	PackName string

	// OutputDir is where to write generated files.
	OutputDir string

	// IncludeVersion embeds the git commit hash as version.
	IncludeVersion bool
}

type ScaffoldResult struct {
	// OutputPath is the path to the generated pack.go file.
	OutputPath string

	// Skills lists the skills included in the pack.
	Skills []string

	// Version is the embedded version (git commit hash).
	Version string

	// GeneratedAt is when the pack was generated.
	GeneratedAt time.Time
}

type SkillPack interface {
	// Name returns the pack identifier (e.g., "omniagent-skills").
	Name() string

	// Version returns the pack version or source commit hash.
	// For packs derived from external sources (like OpenClaw),
	// this should be the source commit hash for traceability.
	Version() string

	// FS returns the embedded filesystem containing skills.
	// Skills are expected at skills/<name>/SKILL.md following
	// the OpenClaw SKILL.md format with YAML frontmatter.
	FS() embed.FS
}

type ValidateConfig struct {
	// SkillsDir is the directory containing skills to validate.
	SkillsDir string

	// Strict treats warnings as errors.
	Strict bool

	// RequireInstall requires install instructions.
	RequireInstall bool

	// RequireBins requires binary declarations.
	RequireBins bool
}

type ValidationError struct {
	// Skill is the name of the skill with the error.
	Skill string

	// Field is the problematic field (e.g., "name", "metadata.openclaw.requires").
	Field string

	// Message describes the validation failure.
	Message string

	// Severity is "error" or "warning".
	Severity string
}

type ValidationResult struct {
	// Valid is true if all validations passed (no errors, warnings OK).
	Valid bool

	// Errors are validation failures that must be fixed.
	Errors []ValidationError

	// Warnings are issues that should be addressed but don't block.
	Warnings []ValidationError

	// Skills lists successfully validated skills.
	Skills []string
}