skill

type AddParams struct {
	WorkspaceID           *string
	Name                  string
	Description           string
	Triggers              []string
	Steps                 []string
	FailureModes          []string
	VerificationChecklist []string
	Examples              []any
	SourceAtomIDs         []string
}

type SearchFilter struct {
	WorkspaceID *string
	Query       string
	Limit       int
}

type Skill struct {
	ID                    string     `json:"id"`
	WorkspaceID           *string    `json:"workspace_id,omitempty"`
	Name                  string     `json:"name"`
	Description           string     `json:"description"`
	Triggers              []string   `json:"triggers"`
	Steps                 []string   `json:"steps"`
	FailureModes          []string   `json:"failure_modes"`
	VerificationChecklist []string   `json:"verification_checklist"`
	Examples              []any      `json:"examples"`
	SourceAtomIDs         []string   `json:"source_atom_ids"`
	SuccessCount          int        `json:"success_count"`
	FailureCount          int        `json:"failure_count"`
	LastUsedAt            *time.Time `json:"last_used_at,omitempty"`
	CreatedAt             time.Time  `json:"created_at"`
	UpdatedAt             time.Time  `json:"updated_at"`
}

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

type StoreIface interface {
	// Add inserts a new skill and returns the persisted record.
	Add(ctx context.Context, p AddParams) (*Skill, error)

	// Search returns skills whose name or description match f.Query (ILIKE/LIKE),
	// scoped to f.WorkspaceID when non-nil, ordered by success_count DESC.
	Search(ctx context.Context, f SearchFilter) ([]*Skill, error)

	// IncrementSuccess increments success_count and sets last_used_at = NOW().
	// Returns ErrNotFound when no matching row exists.
	IncrementSuccess(ctx context.Context, id string, workspaceID *string) (*Skill, error)

	// UpdateFromOutcome increments the success or failure counter, appends an
	// example entry {"outcome_id":"…","notes":"…","at":"…"} to examples, and
	// sets last_used_at = NOW(). Returns ErrNotFound when no matching row exists.
	UpdateFromOutcome(ctx context.Context, p UpdateFromOutcomeParams, workspaceID *string) (*Skill, error)

	// ListRelevant returns skills ordered by success_count DESC, last_used_at DESC,
	// optionally filtered by query (name/description LIKE), scoped to workspaceID.
	ListRelevant(ctx context.Context, workspaceID *string, query string, limit int) ([]*Skill, error)
}

type UpdateFromOutcomeParams struct {
	SkillID   string
	OutcomeID string // code-layer reference; Memory-3 outcome row ID (TEXT, no FK)
	Success   bool
	Notes     string
}