7aba31f14aed7f2620e4746b54f9569a5c93e1ad
braney
  Sat Sep 12 15:07:34 2026 -0700
docent: ten regression tests for quickLift, on hgTracks and on hgc, refs #38252

Fourteen scripts here already lift something -- they are the ones that call
`convert: {quicklift: true}` -- so these take the parts of the lift that had no
test.  Five read the lifted image and five read a details page:

rm38032  the target keeps the source's track order.  First use of `ordered:`,
which was added to expect: for this bug
rm38042  a ClinVar CNV running past the chains quickLift loads is clipped
rather than dropped, so the spanned-item merge still has it
rm37646  a lolly composite subtrack lifts, and its map boxes still carry its
own track name -- the string the stale pop pointer clobbered
rm36048  the spanned-item merge still works on a lifted DECIPHER track
rm37815  "Hide all default tracks on the target" hides all six of hs1's own
tracks and keeps the lifted one
rm36059  a lifted GENCODE Versions item gives the real details page, in
destination coordinates, with no "Can't start query"
rm36370  a lifted knownGene click renders GeneReviews and Methods, the two
sections the ticket says were missing
rm36125  a lifted RefSeq item's page, and its Predicted Protein link
returning SHH's peptide instead of a blank page
rm36942  the Alignment Differences description, reached from a difference
item: the four colors and the figure
rm38146  the same page with a GenArk assembly as the SOURCE, down to the base
alignment that reads query bases out of a two bit file

All ten are assertion-only: every fix shipped long ago.  make test is 57 of 57
green in 10m18s, up from 7m34s -- each script costs a convert, about 17 seconds,
because no URL builds a quickLift hub.

README.txt gains what the batch cost.  A lifted row and map box carry a per-run
hub_<n>_ prefix, so rows: matches by suffix and a has: selector must use a
substring.  Never assert a count an otto reload can move: rm38042 and rm36048
both read the merged-item box and leave its count (45 for ClinVar today) to a
comment.  And a details page prints the track's own labels whether or not it
worked, so each hgc assertion names something only the fixed page has.

Three candidates were rejected: #38033's "(N items could not be lifted)" label
is only in the drawn image and the page JSON, where no expect: check reaches it;
#37970 needs a broadPeak track and hg38 has none; #37974's center-label drag is
pixels.

diff --git src/hg/utils/docent/tests/regress/rm36942.docent.yaml src/hg/utils/docent/tests/regress/rm36942.docent.yaml
new file mode 100644
index 00000000000..669ee72c944
--- /dev/null
+++ src/hg/utils/docent/tests/regress/rm36942.docent.yaml
@@ -0,0 +1,46 @@
+# #36942 -- the Alignment Differences track had no description of what its colors mean.
+# The track draws quickLift's liftOver differences as triangles and lines, and a reader
+# had no way to find out that green is an insertion and blue a deletion.
+#
+# 1b4f89e8c61 created the placeholder page and e1428851a49 wrote it: the four colors, the
+# figure showing a triangle mouseOver, and the sentence about clicking one.  The file is
+# hg/htdocs/goldenPath/help/quickLiftChain.html, and it has been edited since -- the
+# sentence now reads "Clicking a triangle opens a details page showing:" -- so the
+# assertions name what the page says today rather than what the commit added.
+#
+# A track description is only worth testing where the user meets it, which is the details
+# page of an item in the track, so this lifts a track, clicks a difference, and reads the
+# Description section that hgc prints under it.  That also makes it a test of the details
+# page being reachable at all -- see rm38146 for the same page with a hub assembly as the
+# source.
+#
+# The colors are asserted by their names rather than by pixel or by hex, because what the
+# ticket asked for is a legend a reader can follow: "Double-sided insertions" is the entry
+# nothing else on the page would produce, and the figure is named as well, since a
+# description that lost its image would still pass on the words alone.
+proof:
+  - "assertion-only 2026-09-12 -- written from the ticket and from e1428851a49, after the fix shipped"
+
+target: genome-test
+db: hg38
+position: chr7:155799529-155812871
+reset: true
+fast: true
+steps:
+  - go: chr7:155799529-155812871
+  - hide: all
+  - track: {mane: pack}
+  - expect: {rows: [ruler, mane], exact: true}
+
+  - convert: {to: hs1, quicklift: true, hideDefaults: true}
+  - open: lift
+
+  # The Alignment Differences track is the synthetic quickLiftChain row that hubConnect
+  # adds to the lifted hub; it is not in the hub file.
+  - expect: {rows: [quickLiftChain, mane], noText: "Warning/Error"}
+
+  - click: {track: quickLiftChain, frac: 0.5}
+  - expect:
+      text: "Double-sided insertions"
+      has: 'img[src*="quickLiftTrianglesMouseOver"]'
+  - expect: {text: "Clicking a triangle opens a details page showing"}