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
	Validation []SkillValidationFinding
}

type AuditSeverity string

type BridgeDef struct {
	Command string            `json:"command"`        // executable name or path
	Args    []string          `json:"args,omitempty"` // default arguments prepended to each call
	Env     map[string]string `json:"env,omitempty"`  // extra environment variables
}

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

type Components struct {
	// SkillsDir is relative to the plugin root (default "skills").
	SkillsDir string `json:"skills_dir,omitempty"`
	// HooksDir is relative to the plugin root (default "hooks").
	HooksDir string `json:"hooks_dir,omitempty"`
	// MCPFile is path to mcp.json (default "mcp.json").
	MCPFile string `json:"mcp_file,omitempty"`
	// Skills lists explicit skill subdirectory names under SkillsDir.
	Skills []string `json:"skills,omitempty"`
	// MCP lists inline MCP server specs (merged with mcp.json if present).
	MCP []MCPServerSpec `json:"mcp,omitempty"`
}

type DiscoveredComponents struct {
	Root       string
	Skills     []string // absolute paths to SKILL.md parent dirs
	HookFiles  []string // absolute paths under hooks/
	MCPServers []MCPServerSpec
	HasTools   bool // plugin.json tools or tools/ present
}

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 FilesystemSkillProvider struct {
	// contains filtered or unexported fields
}

type GlobalSkillRegistry 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 MCPServerSpec struct {
	Name    string            `json:"name"`
	Command string            `json:"command,omitempty"`
	Args    []string          `json:"args,omitempty"`
	URL     string            `json:"url,omitempty"` // remote streamable HTTP
	Env     map[string]string `json:"env,omitempty"`
}

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"`
	Bridge      *BridgeDef   `json:"bridge,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"`
	MinRhoVersion string         `json:"min_rho_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)

	// V3 multi-component package (Year 0 PACK-05)
	// A plugin may ship tools + hooks + skills + MCP servers in one package.
	Components *Components `json:"components,omitempty"`
}

type MarketplaceClient struct {
	Sources  []MarketplaceSource
	CacheDir string
	// contains filtered or unexported fields
}

type MarketplaceEntry struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Repo        string   `json:"repo"` // owner/name or full git URL
	Version     string   `json:"version,omitempty"`
	Tags        []string `json:"tags,omitempty"`
	Homepage    string   `json:"homepage,omitempty"`
}

type MarketplaceIndex struct {
	Version   int                `json:"version"`
	UpdatedAt string             `json:"updated_at,omitempty"`
	Plugins   []MarketplaceEntry `json:"plugins"`
}

type MarketplaceSource struct {
	Name string `json:"name"`
	URL  string `json:"url"`
}

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

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

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
	IsWasm      bool   // true if this tool is from a WASM plugin
}

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 RuntimeSkillProvider struct {
	// contains filtered or unexported fields
}

type Scope string

type ScopeDir struct {
	Scope Scope
	Path  string
}

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

type Skill struct {
	Name         string
	Description  string
	Content      string
	Path         string
	Provider     string
	ResourceBase string
	Invocation   SkillInvocationPolicy
}

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,omitempty"`
	Repo         string                `json:"repo,omitempty"`
	Path         string                `json:"path,omitempty"`
	Category     string                `json:"category,omitempty"`
	Tags         []string              `json:"tags,omitempty"`
	Version      string                `json:"version,omitempty"`
	License      string                `json:"license,omitempty"`
	Agents       []string              `json:"agents,omitempty"`
	Installs     int                   `json:"installs,omitempty"`
	UpdatedAt    string                `json:"updated_at,omitempty"`
	Invocation   SkillInvocationPolicy `json:"invocation"`
	Provider     string                `json:"provider,omitempty"`
	Content      string                `json:"content,omitempty"`
	ResourceBase string                `json:"resource_base,omitempty"`
}

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

type SkillInvocationPolicy struct {
	ModelInvocable *bool `json:"model_invocable,omitempty"`
	UserInvocable  *bool `json:"user_invocable,omitempty"`
}

type SkillProvider interface {
	Name() string
	List(ctx context.Context, cwd string) ([]SkillEntry, error)
	Get(ctx context.Context, cwd, name string) (*SkillEntry, error)
}

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 SkillValidationFinding struct {
	Path     string
	Severity AuditSeverity
	Message  string
}

type SkillsLock struct {
	Version int                        `json:"version"`
	Skills  map[string]SkillsLockEntry `json:"skills"`
}

type SkillsLockEntry struct {
	Source       string `json:"source"`               // e.g. "owner/repo"
	SourceType   string `json:"source_type"`          // "github"
	SkillPath    string `json:"skill_path,omitempty"` // path inside the repo
	Commit       string `json:"commit,omitempty"`     // HEAD sha at clone time
	ComputedHash string `json:"computed_hash"`        // sha256 of the installed SKILL.md
}

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 (rho, 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 ThreatCategory string

type ThreatMatch struct {
	Category ThreatCategory `json:"category"`
	Pattern  string         `json:"pattern"`
	Line     int            `json:"line"` // 1-indexed
	Context  string         `json:"context"`
}

type ThreatScanResult struct {
	Score    int           `json:"score"` // 0-100, higher = safer
	Threats  []ThreatMatch `json:"threats,omitempty"`
	Blocked  bool          `json:"blocked"` // Score < threatBlockedThreshold: refuse install
	Warnings bool          `json:"warnings"`
}

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"`
	MinRhoVersion string         `json:"min_rho_version"`
}

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

type WasmManifest struct {
	Name          string        `json:"name"`
	Version       string        `json:"version"`
	Description   string        `json:"description"`
	Author        string        `json:"author"`
	Tools         []WasmToolDef `json:"tools"`
	Permissions   []string      `json:"permissions"`
	MinRhoVersion string        `json:"min_rho_version"`
	WasmPath      string        `json:"wasm_path"` // relative path to .wasm file
}

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

type WasmToolDef struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description"`
	InputSchema map[string]interface{} `json:"input_schema"`
}