v2

type CreateRuleInput struct {
	TargetEntityID    uuid.UUID `json:"target_entity_id"`
	RuleType          RuleType  `json:"rule_type"`
	MatchValue        string    `json:"match_value"`
	Priority          int       `json:"priority"`
	MaxLinksPerSource int       `json:"max_links_per_source"`
	IsActive          bool      `json:"is_active"`
	AnchorText        *string   `json:"anchor_text,omitempty"`
	Source            string    `json:"source,omitempty"`
}

type EquityDetailRow struct {
	SourceEntityID  uuid.UUID `json:"source_entity_id"`
	SourceName      string    `json:"source_name"`
	SourceSlug      string    `json:"source_slug"`
	SourceSchema    string    `json:"source_schema"`
	AnchorText      string    `json:"anchor_text"`
	Href            string    `json:"href"`
	OccurrenceIndex int       `json:"occurrence_index"`
}

type EquityReport struct {
	Targets []EquityTargetRow `json:"targets"`
	// LinksTotal is the total row count in hatamoto_entity_link_index — a
	// quick sanity number for the dashboard header.
	LinksTotal int `json:"links_total"`
	// UniqueSources is the number of distinct source entities that contain
	// any inbound link.
	UniqueSources int `json:"unique_sources"`
}

type EquityTargetRow struct {
	TargetEntityID uuid.UUID `json:"target_entity_id"`
	TargetName     string    `json:"target_name"`
	TargetSlug     string    `json:"target_slug"`
	TargetSchema   string    `json:"target_schema"`
	// InboundTotal is the total number of <a> wrappers pointing at this
	// target across every source entity.
	InboundTotal int `json:"inbound_total"`
	// InboundBySourceSchema breaks the total down by the schema of the
	// linking source (blog, service, page, …) so the dashboard can answer
	// "where are these links coming from?" without a second query.
	InboundBySourceSchema map[string]int `json:"inbound_by_source_schema"`
	// Tier is derived from the max priority of any active manual rule
	// targeting this entity: 100→"primary", 90→"secondary", 70-89→"cluster",
	// else "". Drives the pillar dashboard filter and badges on the equity
	// page. The hierarchy itself lives in hatamoto_internal_link_rules.priority
	// so adding a new pillar is a single UPDATE, not a code change.
	Tier string `json:"tier"`
}

type InsertInput struct {
	SourceEntityID   uuid.UUID
	TargetEntityID   uuid.UUID
	TargetSlug       string
	TargetSchemaSlug string
	AnchorText       string
	CanonicalURL     string
}

type InsertResult struct {
	Inserted    bool
	SkipReason  string
	NewContent  string
	ContentSize int
}

type LinkRule struct {
	ID                uuid.UUID `json:"id"`
	TargetEntityID    uuid.UUID `json:"target_entity_id"`
	RuleType          RuleType  `json:"rule_type"`
	MatchValue        string    `json:"match_value"`
	Priority          int       `json:"priority"`
	MaxLinksPerSource int       `json:"max_links_per_source"`
	IsActive          bool      `json:"is_active"`
	AnchorText        *string   `json:"anchor_text,omitempty"`
	Source            string    `json:"source"`
	CreatedAt         time.Time `json:"created_at"`
	UpdatedAt         time.Time `json:"updated_at"`

	// Joined fields
	TargetEntityName string `json:"target_entity_name,omitempty"`
	TargetEntitySlug string `json:"target_entity_slug,omitempty"`
	TargetSchemaSlug string `json:"target_schema_slug,omitempty"`
	LinkCount        int    `json:"link_count"` // Number of active v2 links pointing at the target
}

type LinkSpec struct {
	TargetEntityID   uuid.UUID
	TargetSlug       string
	TargetSchemaSlug string
	AnchorText       string
	CanonicalURL     string
}

type NoopSuggester struct{}

type PaginatedRulesResult struct {
	Rules      []*LinkRule `json:"rules"`
	Total      int         `json:"total"`
	Page       int         `json:"page"`
	PerPage    int         `json:"per_page"`
	TotalPages int         `json:"total_pages"`
}

type ParsedLink struct {
	TargetEntityID  uuid.UUID
	AnchorText      string
	Href            string
	OccurrenceIndex int
}

type RuleFilter struct {
	RuleType       RuleType   `json:"rule_type,omitempty"`
	IsActive       *bool      `json:"is_active,omitempty"`
	Source         string     `json:"source,omitempty"`
	Query          string     `json:"q"`
	TargetEntityID *uuid.UUID `json:"target_entity_id"`
	Page           int        `json:"page"`
	PerPage        int        `json:"per_page"`
	Sort           string     `json:"sort"`
	Order          string     `json:"order"`
}

type RulePreviewMatch struct {
	EntityID   uuid.UUID `json:"entity_id"`
	EntityName string    `json:"entity_name"`
	EntitySlug string    `json:"entity_slug"`
	SchemaSlug string    `json:"schema_slug"`
	Status     string    `json:"status"`
	SkipReason string    `json:"skip_reason,omitempty"`
}

type RulePreviewResult struct {
	// MatchCount is the number of source entities mentioning the phrase
	// (every status). InsertableCount is the subset the suggester would offer.
	MatchCount      int                `json:"match_count"`
	InsertableCount int                `json:"insertable_count"`
	LinkedCount     int                `json:"linked_count"`
	Matches         []RulePreviewMatch `json:"matches"`
}

type RuleType string

type Suggester interface {
	Suggest(ctx context.Context, sourceEntityID uuid.UUID) ([]Suggestion, error)
}

type Suggestion struct {
	TargetEntityID   uuid.UUID `json:"target_entity_id"`
	TargetName       string    `json:"target_name"`
	TargetSchemaSlug string    `json:"target_schema_slug"`
	AnchorPhrase     string    `json:"anchor_phrase"`
	URL              string    `json:"url"`
	// Status is "insertable" when WrapAll would successfully wrap on a fresh
	// copy of the source content, else "skipped" with SkipReason populated.
	// The panel UI uses this to render an Insert button vs a greyed row with
	// the reason ("already linked to /blog/seo", "inside <code>", …).
	Status     string `json:"status"`
	SkipReason string `json:"skip_reason,omitempty"`
	Priority   int    `json:"priority"`
}

type URLBuilder interface {
	// BuildURL renders the path for an entity of schemaSlug. attrs are the
	// entity's attributes flattened to strings (pattern overrides compare
	// against them; nil is fine). known is false when no schema matches.
	BuildURL(schemaSlug string, attrs map[string]string, v urlpattern.Vars) (path string, known bool, err error)
}

type UpdateRuleInput struct {
	TargetEntityID    *uuid.UUID `json:"target_entity_id,omitempty"`
	MatchValue        *string    `json:"match_value,omitempty"`
	Priority          *int       `json:"priority,omitempty"`
	MaxLinksPerSource *int       `json:"max_links_per_source,omitempty"`
	IsActive          *bool      `json:"is_active,omitempty"`
	AnchorText        *string    `json:"anchor_text,omitempty"`
}

type WrapOutcome struct {
	Inserted   bool
	SkipReason string
}

type WrapResult struct {
	NewHTML  string
	Inserted int
	Skips    map[string]int
}