plugin

type AuditFinding struct {
	File     string
	Line     int
	Column   int
	Severity AuditSeverity
	Category string
	Message  string
	Char     rune
}

type AuditResult struct {
	Findings []AuditFinding
	Files    int
}

type AuditSeverity string

type CommandDef struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Script      string `json:"script,omitempty"`
}

type DynamicPlugin struct {
	Plugin      // embed existing Plugin
	State       PluginState
	Error       string // last error message
	ActivatedAt time.Time
	Process     *PluginProcess // running process (for long-lived plugins)
	HookIDs     []string       // registered hook IDs (for cleanup on deactivate)
	ManifestV2  *ManifestV2    // extended manifest if available
}

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

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

type HookDef struct {
	Event   string `json:"event"`
	Command string `json:"command"`
}

type HookRegistrar interface {
	RegisterHook(id string, event string, fn func(ctx context.Context, data map[string]interface{}) error)
	UnregisterHook(id string)
}

type LearnContext struct {
	Signals    []ProjectSignal
	Installed  []SmartSkill
	Registry   []SkillEntry
	SourceInfo string // populated by /learn deep
}

type MalwareCheckResult struct {
	Safe     bool
	Warnings []string
	Blocked  []string
}

type Manifest struct {
	Name        string       `json:"name"`
	Version     string       `json:"version"`
	Description string       `json:"description,omitempty"`
	Author      string       `json:"author,omitempty"`
	Commands    []CommandDef `json:"commands,omitempty"`
	Skills      []string     `json:"skills,omitempty"`
	Hooks       []HookDef    `json:"hooks,omitempty"`
}

type ManifestHook struct {
	Event    string `json:"event"`              // hook event type (e.g. "pre_tool", "post_query")
	Command  string `json:"command"`            // shell command to run
	Async    bool   `json:"async,omitempty"`    // fire-and-forget
	Priority int    `json:"priority,omitempty"` // lower = earlier (default 100)
}

type ManifestTool struct {
	Name           string                 `json:"name"`
	Description    string                 `json:"description"`
	Command        string                 `json:"command"`
	Args           []string               `json:"args"`
	InputSchema    map[string]interface{} `json:"input_schema"`
	TimeoutSeconds int                    `json:"timeout_seconds"`
}

type ManifestV2 struct {
	// V1 fields (backward compatible)
	Name           string         `json:"name"`
	Version        string         `json:"version"`
	Description    string         `json:"description"`
	Author         string         `json:"author"`
	Tools          []ManifestTool `json:"tools"`
	Permissions    []string       `json:"permissions"`
	MinHawkVersion string         `json:"min_hawk_version"`

	// V2 extensions
	Mode         string                 `json:"mode,omitempty"`         // "subprocess" (default) or "daemon"
	Hooks        []ManifestHook         `json:"hooks,omitempty"`        // event hooks
	Config       map[string]interface{} `json:"config,omitempty"`       // plugin configuration
	Dependencies []string               `json:"dependencies,omitempty"` // other plugin names required
	Repository   string                 `json:"repository,omitempty"`   // git repo URL
	License      string                 `json:"license,omitempty"`
	Entrypoint   string                 `json:"entrypoint,omitempty"` // main binary (for daemon mode)
}

type Plugin struct {
	Name        string
	Version     string
	Description string
	Author      string
	Tools       []PluginTool
	Path        string
	Manifest    *ToolManifest
}

type PluginEvent struct {
	Type       string // "activated", "deactivated", "failed", "installed"
	PluginName string
	Timestamp  time.Time
	Error      string
}

type PluginManager struct {
	PluginDirs []string
	Loaded     map[string]*Plugin
	// contains filtered or unexported fields
}

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

type PluginState string

type PluginStatus struct {
	Name        string
	Version     string
	State       PluginState
	ToolCount   int
	HookCount   int
	Error       string
	ActivatedAt time.Time
}

type PluginTool struct {
	Name        string
	Description string
	InputSchema map[string]interface{}
	Command     string
	Timeout     time.Duration
	PluginName  string // namespaced: which plugin owns this tool
}

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

type ProjectSignal struct {
	Category string // language, framework, pattern, tool
	Name     string // e.g. "go", "react", "docker"
}

type RegistryClient struct {
	IndexURL string
	CacheDir string
	// contains filtered or unexported fields
}

type Runtime struct {
	SmartSkills []SmartSkill
	// contains filtered or unexported fields
}

type SecurityIssue struct {
	Severity string
	Message  string
	File     string
	Line     int
}

type Skill struct {
	Name        string
	Description string
	Content     string
}

type SkillChain struct {
	After     []string // skills that should run before this one
	Before    []string // skills to suggest after this one completes
	Conflicts []string // skills that cannot be active simultaneously
	Enhances  []string // skills that work well together (advisory)
}

type SkillEntry struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Author      string   `json:"author"`
	Repo        string   `json:"repo"`
	Path        string   `json:"path"`
	Category    string   `json:"category"`
	Tags        []string `json:"tags"`
	Version     string   `json:"version"`
	License     string   `json:"license"`
	Agents      []string `json:"agents"`
	Installs    int      `json:"installs"`
	UpdatedAt   string   `json:"updated_at"`
}

type SkillIndex struct {
	Version   int          `json:"version"`
	UpdatedAt string       `json:"updated_at"`
	Skills    []SkillEntry `json:"skills"`
}

type SkillRating struct {
	Skill   string    `json:"skill"`
	Rating  int       `json:"rating"` // 1-5
	Comment string    `json:"comment,omitempty"`
	Date    time.Time `json:"date"`
}

type SkillSource struct {
	Repo        string `json:"repo,omitempty"`
	Ref         string `json:"ref,omitempty"`
	InstalledAt string `json:"installed_at,omitempty"`
}

type SmartSkill struct {
	Name          string
	Description   string   // used for auto-matching against user prompts
	Paths         []string // glob patterns that trigger this skill
	Content       string   // skill prompt content (body of SKILL.md)
	AutoInvoke    bool     // if true, model can trigger without user /command
	Compatibility string   // environment requirements (per spec)
	AllowedTools  string   // pre-approved tools, space-separated (per spec)
	Version       string   // semver for update tracking
	Author        string   // skill author
	License       string   // license identifier (MIT, Apache-2.0, etc.)
	Category      string   // engineering, ops, testing, security, devtools, workflow
	Tags          []string // discovery tags
	Agents        []string // cross-agent compatibility (hawk, claude-code, etc.)
	Source        SkillSource
	Invoke        string   // namespaced invocation pattern (e.g. "/vendor:skill")
	Refs          []string // declared @ref() references in SKILL.md
	RefDir        string   // path to references/ directory
	Chain         SkillChain
}

type ToolManifest struct {
	Name           string         `json:"name"`
	Version        string         `json:"version"`
	Description    string         `json:"description"`
	Author         string         `json:"author"`
	Tools          []ManifestTool `json:"tools"`
	Permissions    []string       `json:"permissions"`
	MinHawkVersion string         `json:"min_hawk_version"`
}

type ToolRegistrar interface {
	AddTool(name string, t interface{})
	RemoveTool(name string)
}