docs(config): note settings.* as a legacy alias for 11 gate/AI-review fields

Part of loopover#6444 (Batch C): confirms gate.* is already the canonical,
exclusively-documented form for reviewCheckMode, linkedIssueGateMode,
duplicatePrGateMode, qualityGateMode, qualityGateMinScore,
selfAuthoredLinkedIssueGateMode, and the five aiReview* fields across every
.loopover.yml example and self-hosting doc. Adds the still-supported
settings.* legacy-alias spellings to the two exhaustive reference files
(.loopover.yml.example, loopover.full.yml) and a short note in tuning.mdx,
since those files previously didn't mention this alias at all for these
fields.

Author: JSONbored

.loopover.yml.example

@@ -730,6 +730,26 @@ review:
 # Everything a maintainer can toggle in the dashboard can be set here as code.
 # All values shown are the safe defaults; delete any line to inherit it.
 settings:
+  # The 11 fields below each have a friendlier `gate.<name>` alias documented in section 2 above
+  # (`gate.checkMode`/`gate.enabled`, `gate.linkedIssue`, `gate.duplicates`, `gate.readiness.mode`/
+  # `gate.readiness.minScore`, `gate.selfAuthoredLinkedIssue`, `gate.aiReview.mode`/`.byok`/`.provider`/
+  # `.model`/`.allAuthors`). `gate.*` is the RECOMMENDED spelling going forward and wins whenever both
+  # forms are set for the same field (see PRECEDENCE at the top of this file). The generic names below
+  # remain fully supported (no functional deprecation, still DB-backed) and are shown here, commented
+  # out, only so this reference stays discoverable for a config written before the `gate:` alias
+  # existed. Prefer `gate.*` above for anything new.
+  # reviewCheckMode: visible                   # alias of gate.checkMode / gate.enabled
+  # linkedIssueGateMode: advisory               # alias of gate.linkedIssue
+  # duplicatePrGateMode: block                  # alias of gate.duplicates
+  # qualityGateMode: advisory                   # alias of gate.readiness.mode
+  # qualityGateMinScore: null                   # alias of gate.readiness.minScore
+  # selfAuthoredLinkedIssueGateMode: advisory   # alias of gate.selfAuthoredLinkedIssue
+  # aiReviewMode: off                           # alias of gate.aiReview.mode
+  # aiReviewByok: false                         # alias of gate.aiReview.byok
+  # aiReviewProvider: null                      # alias of gate.aiReview.provider
+  # aiReviewModel: null                         # alias of gate.aiReview.model
+  # aiReviewAllAuthors: false                   # alias of gate.aiReview.allAuthors
+
   # Who receives the public PR comment.
   # off | detected_contributors_only | all_prs. Default: detected_contributors_only.
   commentMode: detected_contributors_only

apps/loopover-ui/content/docs/tuning.mdx

@@ -205,6 +205,12 @@ gate evaluation, comments, labels, audit, or autonomous merge/close on or off 
 dimension modes below directly, and set `gate.checkMode` explicitly instead of
 the ambiguous `gate.enabled`. The main dimensions:
 
+Several of these also have a generic `settings.<field>` spelling (for example
+`settings.linkedIssueGateMode`, `settings.qualityGateMode`,
+`settings.aiReviewMode`) — that spelling remains fully supported for backward
+compatibility, but the `gate.*` form shown below is the recommended one going
+forward and wins whenever both are set for the same field.
+
 - `gate.pack` — the policy pack: `gittensor` (default; registry-aware,
   tracks confirmed-Gittensor-contributor status for scoring) or `oss-anti-slop`
   (runs the deterministic rules against any author on any repo, with no

config/examples/loopover.full.yml

@@ -744,6 +744,26 @@ review:
 # Everything a maintainer can toggle in the dashboard can be set here as code.
 # All values shown are the safe defaults; delete any line to inherit it.
 settings:
+  # The 11 fields below each have a friendlier `gate.<name>` alias documented in section 2 above
+  # (`gate.checkMode`/`gate.enabled`, `gate.linkedIssue`, `gate.duplicates`, `gate.readiness.mode`/
+  # `gate.readiness.minScore`, `gate.selfAuthoredLinkedIssue`, `gate.aiReview.mode`/`.byok`/`.provider`/
+  # `.model`/`.allAuthors`). `gate.*` is the RECOMMENDED spelling going forward and wins whenever both
+  # forms are set for the same field (see PRECEDENCE at the top of this file). The generic names below
+  # remain fully supported (no functional deprecation, still DB-backed) and are shown here, commented
+  # out, only so this reference stays discoverable for a config written before the `gate:` alias
+  # existed. Prefer `gate.*` above for anything new.
+  # reviewCheckMode: visible                   # alias of gate.checkMode / gate.enabled
+  # linkedIssueGateMode: advisory               # alias of gate.linkedIssue
+  # duplicatePrGateMode: block                  # alias of gate.duplicates
+  # qualityGateMode: advisory                   # alias of gate.readiness.mode
+  # qualityGateMinScore: null                   # alias of gate.readiness.minScore
+  # selfAuthoredLinkedIssueGateMode: advisory   # alias of gate.selfAuthoredLinkedIssue
+  # aiReviewMode: off                           # alias of gate.aiReview.mode
+  # aiReviewByok: false                         # alias of gate.aiReview.byok
+  # aiReviewProvider: null                      # alias of gate.aiReview.provider
+  # aiReviewModel: null                         # alias of gate.aiReview.model
+  # aiReviewAllAuthors: false                   # alias of gate.aiReview.allAuthors
+
   # Who receives the public PR comment.
   # off | detected_contributors_only | all_prs. Default: detected_contributors_only.
   commentMode: detected_contributors_only