Rank locally.
Interpret explicitly.

AttentionAggregationProfile {
  aggregationProfileRef,

  profileSourceRef,
  profileSourceOwnerRef,

  factorWeights {
    SIZE,
    CONTRAST,
    ISOLATION,
    POSITION
  },

  aggregation: "WEIGHTED_MEAN",

  comparisonDecimals,

  missingFactorPolicy: "N_A",

  provenance,
  status,
  mutationAllowed: false
}

CandidateAttentionIndex {
  candidateAttentionIndexRef,

  dominanceScopeRef,
  focalCandidateSetRef,
  attentionFactorSetRef,
  aggregationProfileRef,

  focalCandidateRef,
  subjectRef,

  contributingFactorKinds[],

  factorResponsesByKind {},
  factorWeightsByKind {},

  attentionIndex,
  comparisonIndex,

  confidence,
  status,
  provenance: "DERIVED",

  derivedFrom[],
  mutationAllowed: false
}

FocalRankEntry {
  rankEntryRef,

  focalCandidateRef,
  subjectRef,

  rank,
  tieGroupRef,

  attentionIndex,
  comparisonIndex,

  ordinalWithinTie,

  status,
  mutationAllowed: false
}

FocalRanking {
  focalRankingRef,

  dominanceScopeRef,
  focalCandidateSetRef,
  attentionFactorSetRef,
  aggregationProfileRef,

  rankEntries[],

  status,
  reasonCode,
  mutationAllowed: false
}

DominanceMarginDescriptor {
  dominanceMarginRef,

  focalRankingRef,

  candidateCount,

  leaderCandidateRefs[],
  leaderCount,

  topComparisonIndex,
  nearestCompetitorComparisonIndex,

  absoluteMargin,

  status,
  reasonCode,
  mutationAllowed: false
}

DominanceCompetitionPolicy {
  competitionPolicyRef,

  policySourceRef,
  policySourceOwnerRef,

  coDominantMaxMargin,
  singleDominantMinMargin,

  candidateWindowBasis:
    TOP_MINUS_CANDIDATE_COMPARISON_INDEX,

  provenance,
  status,
  mutationAllowed: false
}

DominanceCompetitionDescriptor {
  competitionDescriptorRef,

  focalRankingRef,
  dominanceMarginRef,
  competitionPolicyRef,

  classification,

  leaderCandidateRefs[],
  coDominantCandidateRefs[],
  competingCandidateRefs[],

  absoluteMargin,

  status,
  reasonCode,
  mutationAllowed: false
}

DominanceDescriptorRankingAttachment {
  rankingAttachmentRef,

  attentionAttachmentRef,

  focalRankingRef,
  dominanceMarginRef?,
  competitionDescriptorRef?,

  status,
  mutationAllowed: false
}

13.02 does not mutate the 13.00 descriptor seed or the 13.01 attention attachment.

DominanceRankingCorrectionRequest {
  requestRef,
  targetOwnerRef,

  reasonCode,
  evidenceRefs[],
  suggestedAction,

  status,
  mutationAllowed: false
}

{
  "module": "Compo 13.02",
  "name": "dominance_margin_and_competing_dominants",
  "version": "1.0-canonical",
  "canonical_main_title": "Dominance margin и competing dominants",
  "topic": "13_ДОМИНАНТА_И_ГЛАВНЫЙ_ФОКУС",
  "scope": "EXPLICIT_FACTOR_AGGREGATION_FOCAL_RANKING_DOMINANCE_MARGIN_AND_OBSERVED_COMPETITION_CLASSIFICATION_ONLY",
  "main_topic_contract": {
    "topic_title": "Доминанта и главный фокус",
    "topic_goal": "Define dominance as a measurable leader of attention through focal candidates, dominance margin and competing/co-dominant cases without assuming a universal mandatory single focal center.",
    "expected_output": "DominanceDescriptor, focal rank, dominance margin, target profiles",
    "planned_files": [
      "13.00 Dominant role / focal candidate model",
      "13.01 Attention factors: size, contrast, isolation, position",
      "13.02 Dominance margin и competing dominants",
      "13.03 Target dominance profiles",
      "13.04 Scoring, correction и tests"
    ]
  },
  "ownership": {
    "owner": "Compo13.02",
    "owns": [
      "AttentionAggregationProfile",
      "CandidateAttentionIndex",
      "FocalRankEntry",
      "FocalRanking",
      "DominanceMarginDescriptor",
      "DominanceCompetitionPolicy",
      "DominanceCompetitionDescriptor",
      "DominanceDescriptorRankingAttachment",
      "deterministic rank precision and tie-group semantics",
      "non-mutating ranking/margin correction request"
    ],
    "does_not_own": [
      "DominanceScope / focal candidate eligibility — Compo13.00",
      "raw attention factors and response contexts — Compo13.01",
      "target dominance profiles — Compo13.03",
      "desired dominance structure — Compo13.03",
      "profile satisfaction scoring — Compo13.04",
      "final dominance quality score — Compo13.04",
      "global hierarchy semantics",
      "global rule/conflict priority",
      "foreign geometry or layout mutation"
    ]
  },
  "consumes": [
    "valid Compo13.00 DominanceScope",
    "valid Compo13.00 FocalCandidateSet",
    "valid Compo13.00 DominanceDescriptorSeed",
    "valid Compo13.01 AttentionFactorSet",
    "valid Compo13.01 DominanceDescriptorAttentionAttachment",
    "explicit AttentionAggregationProfile",
    "explicit DominanceCompetitionPolicy"
  ],
  "provides": [
    "AttentionAggregationProfile",
    "CandidateAttentionIndex[]",
    "FocalRanking",
    "DominanceMarginDescriptor",
    "DominanceCompetitionPolicy",
    "DominanceCompetitionDescriptor",
    "DominanceDescriptorRankingAttachment",
    "Topic13.02 observation record"
  ],
  "owns_metrics": [],
  "metric_ownership_note": "13.02 owns derived numeric descriptors (candidate attentionIndex and dominance margin) but no MetricResult score and no independent numeric vote. Final dominance scoring remains 13.04.",
  "aggregation_profile_schema": {
    "aggregationProfileRef": "stable identity",
    "profileSourceRef": "explicit source",
    "profileSourceOwnerRef": "owner",
    "factorWeights": "SIZE|CONTRAST|ISOLATION|POSITION -> finite >=0; at least one >0",
    "aggregation": "WEIGHTED_MEAN",
    "comparisonDecimals": "integer 0..9 used only for deterministic rank precision",
    "missingFactorPolicy": "N_A",
    "provenance": "canonical provenance class",
    "status": "OK|INVALID",
    "mutationAllowed": false,
    "default": "NONE — no implicit equal weights and no universal factor weighting"
  },
  "candidate_attention_index_schema": {
    "candidateAttentionIndexRef": "stable identity",
    "dominanceScopeRef": "scope",
    "focalCandidateSetRef": "candidate set",
    "attentionFactorSetRef": "13.01 matrix",
    "aggregationProfileRef": "explicit profile",
    "focalCandidateRef": "candidate",
    "subjectRef": "candidate subject",
    "contributingFactorKinds": "positive-weight factors",
    "factorResponsesByKind": "copied 13.01 responses",
    "factorWeightsByKind": "copied explicit weights",
    "attentionIndex": "weighted mean in [0,1]",
    "comparisonIndex": "attentionIndex rounded to comparisonDecimals for deterministic rank grouping",
    "confidence": "minimum descriptor confidence among positive-weight factors",
    "status": "OK|N_A|INVALID",
    "provenance": "DERIVED",
    "derivedFrom": "factor vector/set/profile refs",
    "mutationAllowed": false,
    "firewall": "attentionIndex is a ranking descriptor, not a MetricResult vote or final dominance score"
  },
  "rank_precision_policy": {
    "comparisonIndex": "round(attentionIndex * 10^comparisonDecimals) / 10^comparisonDecimals",
    "purpose": "deterministic numerical grouping only",
    "tie": "equal comparisonIndex => same dense rank",
    "lexicalOrder": "candidateRef lexical order only inside exact tie group for deterministic serialization",
    "firewall": "comparisonDecimals is numerical precision, not a perceptual dominance threshold"
  },
  "focal_ranking_schema": {
    "focalRankingRef": "stable identity",
    "dominanceScopeRef": "scope",
    "focalCandidateSetRef": "candidate set",
    "attentionFactorSetRef": "factor set",
    "aggregationProfileRef": "profile",
    "rankEntries": "one entry per candidate",
    "rankingOrder": "descending comparisonIndex, then lexical candidateRef only within ties",
    "rankSemantics": "1-based dense rank",
    "status": "OK|N_A|INVALID",
    "reasonCode": "explicit",
    "mutationAllowed": false,
    "firewall": "rank is observed local attention ordering under one explicit aggregation profile; it is not global hierarchy"
  },
  "focal_rank_entry_schema": {
    "rankEntryRef": "stable identity",
    "focalCandidateRef": "candidate",
    "subjectRef": "subject",
    "rank": "1-based dense rank",
    "tieGroupRef": "stable identity for equal comparisonIndex group",
    "attentionIndex": "unrounded derived weighted mean",
    "comparisonIndex": "rank precision value",
    "ordinalWithinTie": "lexical serialization only; not preference",
    "status": "OK",
    "mutationAllowed": false
  },
  "dominance_margin_schema": {
    "dominanceMarginRef": "stable identity",
    "focalRankingRef": "ranking",
    "candidateCount": ">=2 required",
    "leaderCandidateRefs": "all rank-1 exact comparison ties",
    "leaderCount": "size of leaderCandidateRefs",
    "topComparisonIndex": "maximum",
    "nearestCompetitorComparisonIndex": "highest comparisonIndex among candidates other than a canonical top representative; equals top when exact tie",
    "absoluteMargin": "topComparisonIndex - nearestCompetitorComparisonIndex in [0,1]",
    "status": "OK|N_A|INVALID",
    "reasonCode": "explicit",
    "mutationAllowed": false,
    "singleCandidate": "N_A — no competitor exists; single candidate is not proof of dominance"
  },
  "competition_policy_schema": {
    "competitionPolicyRef": "stable identity",
    "policySourceRef": "explicit interpretation-policy source",
    "policySourceOwnerRef": "owner",
    "coDominantMaxMargin": "finite 0..1",
    "singleDominantMinMargin": "finite 0..1 and > coDominantMaxMargin",
    "candidateWindowBasis": "TOP_MINUS_CANDIDATE_COMPARISON_INDEX",
    "provenance": "canonical provenance class",
    "status": "OK|INVALID",
    "mutationAllowed": false,
    "default": "NONE — no universal co-dominant or clear-dominant threshold"
  },
  "competition_descriptor_schema": {
    "competitionDescriptorRef": "stable identity",
    "focalRankingRef": "ranking",
    "dominanceMarginRef": "margin",
    "competitionPolicyRef": "explicit policy",
    "classification": "CO_DOMINANT|COMPETING_DOMINANTS|SINGLE_DOMINANT",
    "leaderCandidateRefs": "exact rank-1 leader group",
    "coDominantCandidateRefs": "all candidates within coDominantMaxMargin of top comparisonIndex",
    "competingCandidateRefs": "all non-leader candidates within singleDominantMinMargin of top comparisonIndex",
    "absoluteMargin": "copied observed top-to-nearest margin",
    "status": "OK|N_A|INVALID",
    "reasonCode": "explicit",
    "mutationAllowed": false,
    "classificationRules": {
      "CO_DOMINANT": "absoluteMargin <= coDominantMaxMargin",
      "COMPETING_DOMINANTS": "coDominantMaxMargin < absoluteMargin < singleDominantMinMargin",
      "SINGLE_DOMINANT": "absoluteMargin >= singleDominantMinMargin"
    },
    "firewall": "observed classification is not a target profile and not profile satisfaction"
  },
  "ranking_attachment_schema": {
    "rankingAttachmentRef": "stable identity",
    "attentionAttachmentRef": "exact 13.01 attachment",
    "focalRankingRef": "ranking",
    "dominanceMarginRef": "margin or null when N_A",
    "competitionDescriptorRef": "classification or null when N_A",
    "status": "OK|N_A|INVALID",
    "mutationAllowed": false,
    "firewall": "13.02 creates a derived attachment; it does not mutate 13.00 seed or 13.01 attachment"
  },
  "identity_policy": {
    "aggregationProfileRef": "hash(profile source/owner, exact four factor weights, aggregation, comparisonDecimals, missing policy, provenance)",
    "candidateAttentionIndexRef": "hash(candidate, factor set, aggregation profile, contributing factor responses/weights)",
    "tieGroupRef": "hash(ranking context + comparisonIndex + canonical tied candidate refs)",
    "rankEntryRef": "hash(candidate attention index ref + dense rank + tieGroupRef)",
    "focalRankingRef": "hash(scope/candidate set/factor set/profile + canonical rank entries)",
    "dominanceMarginRef": "hash(ranking + leader refs + top/nearest comparison values + absoluteMargin)",
    "competitionPolicyRef": "hash(source/owner + explicit thresholds + window basis + provenance)",
    "competitionDescriptorRef": "hash(ranking + margin + competition policy + classification + canonical candidate sets)",
    "rankingAttachmentRef": "hash(attention attachment + ranking + margin? + competition descriptor?)",
    "excluded_from_identity": [
      "display label",
      "display color",
      "free-form comment",
      "confidence"
    ]
  },
  "status_policy": {
    "candidateAttentionIndex": "OK|N_A|INVALID",
    "focalRanking": "OK|N_A|INVALID",
    "dominanceMargin": "OK for >=2 candidates; N_A for one candidate",
    "competitionDescriptor": "OK only with valid margin + explicit policy; N_A when margin unavailable",
    "missingPositiveWeightFactor": "N_A, not zero",
    "singleCandidateMargin": "N_A, not zero",
    "zeroMargin": "valid observed tie/near-tie result, distinct from N_A",
    "N_A_not_zero": true
  },
  "critical_firewalls": [
    "focal candidate != dominant",
    "attention factor response != dominance",
    "attentionIndex != final dominance score",
    "attentionIndex != independent numeric vote",
    "dominance margin != final dominance score",
    "dominance margin != independent numeric vote",
    "factor weights must be explicit",
    "no implicit equal factor weights",
    "factor weight != global rule priority",
    "factor enumeration order != factor priority",
    "comparisonDecimals != perceptual dominance threshold",
    "lexical order inside a tie != preference",
    "rank 1 != automatically SINGLE_DOMINANT",
    "rank 1 with zero margin may be CO_DOMINANT",
    "single candidate != proven dominant",
    "single candidate margin = N_A",
    "zero margin != N_A",
    "N_A != 0",
    "candidate count != dominance strength",
    "candidate count != vote",
    "higher attentionIndex != global hierarchy",
    "FocalRanking is local to one aggregationProfileRef",
    "cross-profile attentionIndex comparison is not canonical",
    "cross-profile focal rank comparison is not canonical",
    "co-dominant threshold must be explicit",
    "single-dominant threshold must be explicit",
    "no universal dominance margin threshold",
    "CO_DOMINANT != target satisfaction",
    "COMPETING_DOMINANTS != target satisfaction",
    "SINGLE_DOMINANT != target satisfaction",
    "observed competition classification != target dominance profile",
    "target dominance profiles are deferred to 13.03",
    "dominance profile scoring is deferred to 13.04",
    "rank attachment != final DominanceDescriptor",
    "local != global",
    "descriptor != score",
    "module execution order != rule priority",
    "correction request != foreign mutation",
    "no universal beautyScore",
    "IDEA != CANON",
    "EXPERIMENT != CANON"
  ],
  "correction_request_schema": {
    "requestRef": "stable identity",
    "targetOwnerRef": "owner whose aggregation/threshold or upstream factor evidence should be reviewed",
    "reasonCode": "explicit",
    "evidenceRefs": "canonicalized refs",
    "suggestedAction": "non-mutating suggestion",
    "status": "OPEN|INVALID",
    "mutationAllowed": false
  },
  "deferred_downstream": {
    "13.03": [
      "target dominance profiles",
      "desired SINGLE_DOMINANT / COMPETING_DOMINANTS / CO_DOMINANT structures",
      "role/scope applicability of target profiles",
      "target margin ranges",
      "target leader counts"
    ],
    "13.04": [
      "profile satisfaction scoring",
      "dominance correction synthesis",
      "independent Topic13 vote if canonically justified",
      "consolidated Topic13 tests"
    ]
  },
  "IDEAS_REFS": [
    "IDEA-01 full human test after all 72 topics; compare human focal rank and margin perception with explicit aggregation profiles",
    "IDEA-02 semantics needed before placement; observed ranking remains semantic-light and target meaning stays downstream",
    "IDEA-03 explicit rule priorities; factor weights and rank order must not become hidden global priority",
    "IDEA-04 collect structured data for future composition model",
    "IDEA-05 preserve reasons for human corrections",
    "IDEA-06 structured machine-readable layer for website",
    "IDEA-07 graphics-for-post-text research remains downstream/separate"
  ],
  "DATA_CAPTURE": [
    "sceneRef",
    "dominanceScopeRef",
    "focalCandidateSetRef",
    "attentionFactorSetRef",
    "aggregationProfileRef",
    "factorWeights",
    "comparisonDecimals",
    "candidateAttentionIndexRefs[]",
    "attentionIndexByCandidate",
    "comparisonIndexByCandidate",
    "focalRankingRef",
    "rankByCandidate",
    "tieGroupRefs[]",
    "dominanceMarginRef",
    "leaderCandidateRefs[]",
    "absoluteMargin",
    "competitionPolicyRef",
    "coDominantMaxMargin",
    "singleDominantMinMargin",
    "competitionDescriptorRef",
    "classification",
    "coDominantCandidateRefs[]",
    "competingCandidateRefs[]",
    "humanReasonCodes[]",
    "future dominanceProfileRef",
    "future dominanceEvaluationRef"
  ],
  "DEFERRED_SEMANTIC_INPUTS": [
    "semantic desirability of single vs multiple focal centers",
    "role-specific meaning of dominance",
    "brand/editorial hierarchy intent",
    "future target dominance profile refs",
    "future global conflict-priority refs"
  ],
  "HUMAN_FEEDBACK_HOOKS": [
    "FACTOR_WEIGHTS_WRONG",
    "ATTENTION_INDEX_TOO_HIGH",
    "ATTENTION_INDEX_TOO_LOW",
    "FOCAL_RANK_WRONG",
    "TIE_GROUP_WRONG",
    "COMPARISON_PRECISION_WRONG",
    "DOMINANCE_MARGIN_TOO_HIGH",
    "DOMINANCE_MARGIN_TOO_LOW",
    "CO_DOMINANT_THRESHOLD_WRONG",
    "SINGLE_DOMINANT_THRESHOLD_WRONG",
    "COMPETITION_CLASSIFICATION_WRONG",
    "EXPECTED_CO_DOMINANT_NOT_DETECTED",
    "EXPECTED_COMPETING_DOMINANTS_NOT_DETECTED",
    "EXPECTED_SINGLE_DOMINANT_NOT_DETECTED",
    "SINGLE_CANDIDATE_SHOULD_NOT_IMPLY_DOMINANCE"
  ],
  "CONFLICT_PRIORITY_ASSUMPTIONS": [
    "module execution order is not priority",
    "factor weights are local aggregation parameters, not global rule priority",
    "dense rank order is observed output, not rule priority",
    "lexical order only serializes candidates inside exact ties",
    "competition thresholds classify observation but do not express desired target",
    "future reviewed global conflict-priority owner remains authoritative"
  ],
  "LAB_HOOKS": [
    "human A/B: vary one explicit factor weight while holding factor matrix fixed",
    "human rank study: compare measured dense ranking to chosen main focus",
    "human margin study: estimate perceived clear-vs-competing threshold without auto-writing it into canon",
    "co-dominance study: near-tie pairs and multi-candidate clusters",
    "single-candidate scenes: test whether humans infer dominance without competition",
    "cross-profile sensitivity: record rank changes under alternative explicit aggregation profiles"
  ],
  "observation_record": {
    "moduleRef": "Compo13.02",
    "metricResults": [],
    "dominanceProfileRefs": [],
    "dominanceEvaluationRefs": []
  },
  "stop_condition": "STOP after 13.02. Do not create 13.03 in this module."
}