trainhop-adv-target

name	trainhop-adv-target
description	End-to-end New Tab train-hop targeting for the Experimenter repo. From a single trainhop version string, files the GitHub targeting issue, branches, adds the NimbusTargetingConfig entry, lints, and stages a drafted commit. Use for "newtab trainhop targeting" requests.

New Tab Train-hop Targeting

Run the whole recurring train-hop targeting task end-to-end. The only required input is the trainhop version string; everything else is derived.

Input

• Version string, format major.minor.YYYYMMDD.buildid, e.g. 153.4.20260610.40323. If not given, ask for it.
• Fx major for the "includes users of" line — defaults to 151; override only if told.

Steps

1. Ask for the version

If the user didn't supply the trainhop version, ask for it. That is the only input needed.

2. Derive values

From major.minor.YYYYMMDD.buildid:

• Python var: FX_<major>_<minor>_TRAINHOP (drop _<minor> only if minor is 0/first of that major — check what's already in constants.py)
• name: New Tab Fx<major> <Mon>-<DD> Trainhop (month abbrev from YYYYMMDD, e.g. Jun-10)
• slug: newtab-<major>-<MMDD>-trainhop (e.g. newtab-153-0610-trainhop)
• targeting: newtabAddonVersion|versionCompare('<version>') >= 0

3. File the GitHub issue

gh issue create --repo mozilla/experimenter \
  --title "[Targeting] newtab trainhop <version> targeting request" \
  --body "$(cat <<'EOF'
### What is the criteria you need to target based on?

This is to add advanced targeting such that experiments and rollouts can target New Tabs of version \`<version>\` and greater.

This will be very similar to previous targeting requests:

- https://github.com/mozilla/experimenter/issues/15414
- https://github.com/mozilla/experimenter/issues/14888
- https://github.com/mozilla/experimenter/issues/14577
- https://github.com/mozilla/experimenter/issues/14203

### Should the targeting include or exclude users?

Include users of the soon-to-be-released New Tab train-hop for Firefox <fx-major> users on the release channel.

### Additional Notes (optional)

*No response*
EOF
)"

The Jira sync footer is auto-added — leave it out. gh issue create prints the new issue URL; capture the issue number from it for the next steps.

4. Create the branch

git checkout -b <issue-number>-train-hop-<version>

e.g. 15938-train-hop-153.4.20260610.40323.

5. Add the target

Append the new config immediately after the most recent FX_..._TRAINHOP entry in experimenter/experimenter/targeting/constants.py, copying its exact shape:

FX_153_4_TRAINHOP = NimbusTargetingConfig(
    name="New Tab Fx153 Jun-10 Trainhop",
    slug="newtab-153-0610-trainhop",
    description=(
        "Desktop users having the New Tab 153.4.20260610.40323 train hop, "
        "which includes users of Fx151"
    ),
    targeting="newtabAddonVersion|versionCompare('153.4.20260610.40323') >= 0",
    desktop_telemetry="",
    sticky_required=False,
    is_first_run_required=False,
    application_choice_names=(Application.DESKTOP.name,),
)

Confirm the latest entry first: grep -n "TRAINHOP = NimbusTargetingConfig" experimenter/experimenter/targeting/constants.py | tail. This is the only source file that changes.

6. Run ruff

From the experimenter/ directory. Pull the ruff version the repo pins rather than hardcoding it:

RUFF_SPEC=$(grep -m1 '^ruff = ' experimenter/pyproject.toml | sed -E 's/.*"\^?([0-9.]+)".*/\1/')
pipx run --spec "ruff==$RUFF_SPEC" ruff check experimenter/targeting/constants.py
pipx run --spec "ruff==$RUFF_SPEC" ruff format --check --diff experimenter/targeting/constants.py

7. Stage changes and draft the commit message

git add experimenter/experimenter/targeting/constants.py

Print this message — do NOT commit unless asked:

feat(nimbus): Add advanced targeting for newtab trainhop <version>
This commit adds new targeting for the <version> trainhop, which includes users of Fx<fx-major> on the release channel.

Fixes mozilla#<issue-number>

Reference examples

PRs #15676, #15786, #15842 — each is a single ~14-line addition to constants.py.