diff --git a/.github/workflows/demo-pictures.yml b/.github/workflows/demo-pictures.yml index a4f49ac05..1c4806915 100644 --- a/.github/workflows/demo-pictures.yml +++ b/.github/workflows/demo-pictures.yml @@ -2,9 +2,9 @@ name: Demo pictures # Retakes the three docs pictures of DEMO-001, the invented sample # (docs/testing.md, "Retaking the report pictures"), with -# tests/demo/retake-screenshots.sh: it writes the sample from a fixed seed, -# runs steps 36, 27, 24 and 28 on it with the pinned images, draws the -# pictures and checks them. The pictures come back as the artifact +# tests/demo/retake-screenshots.sh: it writes the sample from a fixed seed +# (og dev demo-sample), runs steps 36, 27, 24 and 28 on it with the pinned +# images, draws the pictures and checks them. The pictures come back as the artifact # `demo-pictures`; look at them and commit them into docs/images/ by hand. # Nothing here writes to the repository. # @@ -30,6 +30,8 @@ on: paths: - 'tests/demo/**' - 'tests/og_binary.py' + # og dev demo-sample, which writes the sample the pictures show + - 'rust/crates/og-dev/src/demo/**' - 'tests/fixtures/live/demo-001.weblog.jsonl' - 'tests/fixtures/live/demo/**' - '.github/workflows/demo-pictures.yml' @@ -58,9 +60,8 @@ jobs: sudo apt-get update -q sudo apt-get install -y -q fonts-dejavu-core - # Step 27 runs og in its container (bin/og), and the demo sample - # builder runs it too, for step 27's parser and step 33's mosaic rows - # (tests/og_binary.py finds bin/.og on Linux). + # Step 27 runs og in its container (bin/og), and the script writes the + # demo sample with the same bin/og (og dev demo-sample). - name: Build og as scripts/setup.sh --og does run: | scripts/setup.sh --og @@ -95,9 +96,10 @@ jobs: sudo apt-get update -q sudo apt-get install -y -q fonts-dejavu-core - # og (rust/, docs/rust.md): the demo sample builder runs step 27's - # parser, og pgx cpic-report, and step 33's og qc sex-loss for the - # mosaic rows (tests/og_binary.py reads OG). + # og (rust/, docs/rust.md): the live-site demo writes its sample with + # og dev demo-sample, which runs step 27's og pgx cpic-report, step 33's + # og qc sex-loss and the other verbs of the steps it stands in for + # (OG names the og). - name: Install the toolchain rust/rust-toolchain.toml pins working-directory: rust run: | diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 7a4bee938..47eab7d07 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -30,8 +30,9 @@ on: - 'bin/**' - 'tests/demo/**' - 'tests/fixtures/live/**' - # og builds the demo's Figure 1, the genome map (og map build), its CPIC - # table (og pgx cpic-report) and its mosaic rows (og qc sex-loss). + # og writes the demo sample itself (og dev demo-sample), with its CPIC + # table (og pgx cpic-report) and its mosaic rows (og qc sex-loss), and + # builds the demo's Figure 1, the genome map (og map build). - 'rust/**' - 'tests/fixtures/map/**' - 'tests/og_binary.py' @@ -85,10 +86,10 @@ jobs: - name: Build run: python -m zensical build --clean --strict - # og (rust/, docs/rust.md): the demo sample builder runs step 27's - # parser, og pgx cpic-report (tests/og_binary.py reads OG), writes the - # genome map's documents, og map build, and runs step 33's og qc sex-loss - # for the mosaic rows. + # og (rust/, docs/rust.md): og dev demo-sample writes the demo sample, + # running the og verbs of the steps it stands in for (step 27's + # og pgx cpic-report, step 33's og qc sex-loss and the rest), and + # og map build writes the genome map's documents. - name: Install the toolchain rust/rust-toolchain.toml pins working-directory: rust run: | diff --git a/.github/workflows/e2e.yml b/.github/workflows/e2e.yml index 1b3089448..d6e5a5cbf 100644 --- a/.github/workflows/e2e.yml +++ b/.github/workflows/e2e.yml @@ -66,6 +66,7 @@ on: - 'versions.env' - '.github/workflows/e2e.yml' - 'rust/crates/og-dev/src/fixture.rs' + - 'rust/crates/og-dev/src/traits_sources.rs' - '.github/actions/**' - 'tests/fixtures/annotsv/class45.sh' - 'tests/fixtures/consumer_export/sites.tsv.gz' diff --git a/.github/workflows/guard.yml b/.github/workflows/guard.yml index d203d4668..eaddc7558 100644 --- a/.github/workflows/guard.yml +++ b/.github/workflows/guard.yml @@ -75,6 +75,65 @@ jobs: if: ${{ !cancelled() }} # runs even when a step above failed, so each result shows run: scripts/ci/check-coupled-versions.sh + # MITO_HAPLOGROUP runs haplogrep3 in its Nextflow task directory: the + # pinned build finds its config and trees beside its jar, and the report + # must land where Nextflow collects it. A `cd` or a `readlink -f` in that + # process would bring back the run in the binary's directory, which can be + # read-only. Only that process is checked: the readlink -f of the + # reference in MITO_EXTRACT_CHRM, in the same file, is right. + mito-workdir: + runs-on: ubuntu-latest + timeout-minutes: 5 + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + + # The self-test plants its faults first: a cd or readlink -f in + # MITO_HAPLOGROUP, or a renamed process, must be caught; a cd in + # MITO_EXTRACT_CHRM must not. Then the module itself. + - name: MITO_HAPLOGROUP has no cd and no readlink -f (self-test first) + run: | + set -euo pipefail + # check FILE: exit 1 and name each line when the MITO_HAPLOGROUP + # block (from its process line to the closing brace at column 1) + # has a cd or a readlink -f outside a comment, or when the file has + # no such block. + check() { + awk ' + /^process MITO_HAPLOGROUP[[:space:]]*\{/ { p = 1; seen = 1; next } + p && /^\}/ { p = 0 } + p && !/^[[:space:]]*#/ && (/(^|[^[:alnum:]_.-])cd([[:space:]]|$)/ || /readlink[[:space:]]+-f/) { + print FILENAME ":" FNR ": " $0; bad = 1 + } + END { + if (!seen) { print FILENAME ": no process MITO_HAPLOGROUP"; exit 1 } + exit bad + }' "$1" + } + M=modules/local/mito_haplogroup/main.nf + T=$(mktemp -d) + # plant NAME SED: a copy of the module with one edit; the edit must + # change the file, or the control would test the module itself. + plant() { + sed "$2" "$M" > "${T}/$1.nf" + if cmp -s "$M" "${T}/$1.nf"; then echo "FAIL: the plant $1 changed nothing"; exit 1; fi + } + # shellcheck disable=SC2016 # the planted lines are text, never expanded here + plant cd '/^process MITO_HAPLOGROUP/,/^}/ s|^ haplogrep3 classify| cd "$(dirname "$(command -v haplogrep3)")"\n haplogrep3 classify|' + # shellcheck disable=SC2016 # as above + plant readlink '/^process MITO_HAPLOGROUP/,/^}/ s|^ haplogrep3 classify| BIN=$(readlink -f "$(command -v haplogrep3)")\n haplogrep3 classify|' + plant renamed 's/^process MITO_HAPLOGROUP /process MITO_HAPLOGROUP_X /' + plant chrm-cd '/^process MITO_EXTRACT_CHRM/,/^}/ s|^ { echo ">chrM"| cd .\n { echo ">chrM"|' + for c in cd readlink renamed; do + if out=$(check "${T}/${c}.nf"); then + echo "FAIL: the planted ${c} was not caught"; exit 1 + fi + echo "caught ${c}: ${out}" + done + out=$(check "${T}/chrm-cd.nf") || { echo "FAIL: a cd in MITO_EXTRACT_CHRM was taken for MITO_HAPLOGROUP, or the module already fails:"; echo "$out"; exit 1; } + echo "OK: every plant in MITO_HAPLOGROUP is caught, and MITO_EXTRACT_CHRM is left alone" + check "$M" + echo "OK: MITO_HAPLOGROUP runs haplogrep3 in its task directory" + fake-docker: runs-on: ubuntu-latest timeout-minutes: 20 @@ -887,7 +946,7 @@ jobs: # job above failed or was skipped, and fails unless every one succeeded. ci-ok: if: always() - needs: [image-vars, images, coupled-versions, fake-docker, helper-binaries, og, unit-tests, rust, parity] + needs: [image-vars, images, coupled-versions, mito-workdir, fake-docker, helper-binaries, og, unit-tests, rust, parity] runs-on: ubuntu-latest timeout-minutes: 5 steps: diff --git a/CHANGELOG.md b/CHANGELOG.md index c9dcf0c9a..047e8a6b0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,13 @@ Each release's notes. From 1.0.0 on, a major or minor release has hand-written n ## Unreleased +- Guard's new `mito-workdir` job fails when the Nextflow `MITO_HAPLOGROUP` process has a `cd` or a `readlink -f`: haplogrep3 must run in the task directory. There the pinned build uses the config and trees beside its jar, and Nextflow collects the report. The check reads only that process, so the `readlink -f` of the reference in `MITO_EXTRACT_CHRM` stays allowed. Its self-test plants a `cd`, a `readlink -f` and a renamed process, which must each fail, and a `cd` in `MITO_EXTRACT_CHRM`, which must not. No output changes. +- The 1.0.0 release notes said steps 21, 32 and 9b still run Python for the CYP2D6 depth check and the RFC1 motif count. They run `og`, and the Python files are gone; the notes now say so. `docs/00-reference-setup.md` lists the GIAB tandem-repeat map `setup.sh` installs for step 04c, with its source, its checksum and what the step does without it. +- A change to `rust/crates/og-dev/src/traits_sources.rs`, the source of `og dev traits-sources`, now runs the `traits-panel-1` e2e case, which calls that command. Before, the file was in no case row and not in the e2e scope, so a change to it ran no e2e case. The path is in the case row, in `SCOPE_FILES` of `scripts/ci/e2e-scope.sh` and in the push paths of `e2e.yml`. +- The docs demo sample, DEMO-001, is written by the Rust `og` binary: `og dev demo-sample --genome-dir DIR` writes it and `og dev demo-sample check --genome-dir DIR` stops when a report section is not ok. The picture retake script (`tests/demo/retake-screenshots.sh`), the live-site demo (`tests/demo/build_live_demo.py`) and the report and live-results tests run it in place of `tests/demo/make_demo_sample.py`, which stays only for the older tests that still import or run it (`test_live_journal.py`, `test_lpa_kiv2.py`, `test_report_charts.py`, `test_vcf_precheck_samples.sh`) until they move. Every table a step writes with og is written by that og verb, so the demo shows what the product writes. Every fixed table is byte for byte the Python's (the PharmCAT report, the CPIC tables, blood groups, traits, the ClinVar, AnnotSV and Exomiser rows with the son's planted results), and step 24 reads every section of DEMO-001 as ok. The random values come from a new seeded generator, so the made-up counts, depths and scores of the demo differ from before; the planted findings keep their genes and positions. The retake script now runs `bin/og` on the host instead of `python3`, and its mount probe looks for `bin/og`. Pipeline outputs do not change. +- The live family page keeps a child's closed results out of the de novo and compound-het tables of that child's own children. A person whom one family lists as a child, with a result to act on still unopened, can be a parent in a family with three generations. Their children's trio rows hold their calls: the parent each variant came from, and their genotype at each de novo candidate. The page left out the gated person's own rows but drew those of their children, so the grandparents' family page showed them. Now both tables of a child stay out of the family view while the child or either parent is gated, and chapter IV says so in one fixed line that does not depend on which rows there are. The tables come back once that parent's results are opened on the page. `family.json` does not change; only what the page draws from it. A node test (`tests/test_live_family_hide_closed.sh`) runs `core.js` and `family-page.js` on an invented family, with controls that cut the rule out. +- The live-site docs answer two things a reader looked for and did not find. "Start it" says that Ctrl+C in the site's terminal stops it, and the systemd unit says how to save, start and stop it. "Behind a reverse proxy" says the site needs a host name of its own, served at its root: the pages ask for root paths such as `/login` and `/runs.json`, and there is no flag for a path prefix. Docs only; nothing the site does changes. +- The quick test (Option A, step 1) now says what its download is: the GIAB NA12878 benchmark VCF, chr1 to chr22, about 120 MB. Its comment called it a chr22 VCF and the note under it called it a full-genome VCF of about 250 MB, so the chr22 extract that follows read as a contradiction. The file is 125,932,193 bytes. No command changes. - A new page, [User journeys](docs/user-journeys.md), records where a new user gets stuck on each surface: the docs, the demo, the shell and the local site. It gives the outcome of each journey in the first test-as-user run (2026-11-17, commit `65095e97`), the fix for each finding, and what the run could not reach. A fix that lands has a journey to walk again. - VCF intake now refuses a record with GT after another FORMAT key, such as `DP:GT:GQ`, before a reader can mistake depth for the genotype. The check exits 2 and names the sample, file, first offending position and FORMAT field. It tells users to reorder the keys and sample values together or get a corrected VCF. Records without GT remain allowed by this ordering check. Valid input and output formats are unchanged. Part of #411 (clin-37). - The `archaic-same-person` job of `public-evidence.yml` puts step 43's Neanderthal totals beside Chen et al.'s released calls with `og archaic compare` and `og archaic genomes`, in Rust. They replace `bin/archaic_compare.py`, which is gone with its test, `tests/test_archaic_compare.py`; those checks are now cargo tests in og-ancestry. The tables are the same, byte for byte, on 20 parity cases and on the inputs of the last green run of the job (NA12878, chromosomes 19 to 22). No step of the pipeline runs them, and no option or output changes. What changes on purpose: a missing file, an unreadable number or an empty spans file stops with an `ERROR:` line and exit 1 instead of a Python traceback; an interval with a negative start or an end before its start stops the command, where the Python counted a negative length; and a `--mine` value without `=` is a usage error (exit 2). diff --git a/assets/live/core.js b/assets/live/core.js index ed73d8a2d..3d3f697ae 100644 --- a/assets/live/core.js +++ b/assets/live/core.js @@ -457,11 +457,22 @@ layout: raw.layout ? { width: raw.layout.width, height: raw.layout.height, size: raw.layout.size, lines: copy(raw.layout.lines), people: (raw.layout.people || []).map(function (m) { return { sample: m.sample, sex: m.sex, sequenced: m.sequenced, x: m.x, y: m.y }; }) } : null, couple_note: raw.couple_note, chrom_lengths: copy(raw.chrom_lengths), gated: closed, runs: {} }; + // A child's trio tables (the de novo candidates and the compound-het pairs) are read against the child and its + // parents: a row names the child, and the parent each call or variant comes from. Both tables of a child stay + // out while any of the three is gated, whole, so nothing the page says of them depends on which rows there are. + // The one rule for these rows: the family view and the genome map's family mode get them only through here. + function parentsOf(s) { return (raw.state.members || []).filter(function (m) { return m.sample === s; }).map(function (m) { return [m.father, m.mother]; })[0] || []; } + function parentGated(s) { return parentsOf(s).some(function (p) { return p && gated(p); }); } // Each person keeps the role this family gives them: its children are the ones it lists with a father or a // mother. A gated person it lists as a parent or partner (a child in another family) is in gated alone, and the - // view gives them their buttons beside the children. + // view gives them their buttons beside the children. An open child with a gated parent keeps its entry and + // names that parent in trio_closed: the page says its tables stay closed, the same line whatever rows there are. f.state.children = (raw.state.members || []).filter(function (m) { return m.father || m.mother; }).map(function (m) { - return gated(m.sample) ? { child: m.sample, gated: true } : copy((raw.state.children || []).filter(function (c) { return c.child === m.sample; })[0]); + if (gated(m.sample)) { return { child: m.sample, gated: true }; } + var c = copy((raw.state.children || []).filter(function (x) { return x.child === m.sample; })[0]); + var by = [m.father, m.mother].filter(function (p) { return p && gated(p); }); + if (c && by.length) { c.trio_closed = by; } + return c; }).filter(Boolean); // A row belongs to a gated child when it names that child as one of its members, by exact name. function names(v) { return String(v || '').split(/[\s,;]+/); } @@ -483,9 +494,9 @@ ['segments', 'trio_status', 'trio_files', 'trio_file_state'].forEach(function (key) { if (!raw[key] || typeof raw[key] !== 'object') { return; } f[key] = {}; - Object.keys(raw[key]).forEach(function (k) { if (!gated(k)) { f[key][k] = copy(raw[key][k]); } }); + Object.keys(raw[key]).forEach(function (k) { if (!(key === 'trio_status' ? gated(k) || parentGated(k) : gated(k))) { f[key][k] = copy(raw[key][k]); } }); }); - ['de_novo', 'compound_het'].forEach(function (key) { f[key] = copy((raw[key] || []).filter(function (r) { return !gated(r.child); })); }); + ['de_novo', 'compound_het'].forEach(function (key) { f[key] = copy((raw[key] || []).filter(function (r) { return !gated(r.child); })).filter(function (r) { return !parentGated(r.child); }); }); Object.keys(raw.runs || {}).forEach(function (k) { f.runs[k] = gated(k) ? Object.assign(progressOf(raw.runs[k]), { url: raw.runs[k].url, gated: true }) : copy(raw.runs[k]); }); diff --git a/assets/live/family-page.js b/assets/live/family-page.js index b02455086..4781493a8 100644 --- a/assets/live/family-page.js +++ b/assets/live/family-page.js @@ -389,6 +389,15 @@ } else { add(d, el('p', { 'class': 'dim' }, 'No chromosome map yet: step 38 draws one for a child with a sequenced parent.')); } + // A parent whose report is closed (a child in another family) closes this child's trio tables too: they are + // read against that parent's genome. One fixed line, whatever rows there are; the tables come once it opens. + if (c.trio_closed) { + add(d, el('p', { 'class': 'dim', 'data-trio': 'closed' }, 'The de novo candidates and compound-het pairs stay closed while ' + + c.trio_closed.join(' and ') + (c.trio_closed.length > 1 ? '’s reports are closed: they are read against those genomes.' + : '’s report is closed: they are read against that genome.'))); + add(s, d); + return; + } var dn = (f.de_novo || []).filter(function (r) { return r.child === c.child; }); add(d, el('h3', {}, 'De novo candidates')); if (dn.length) { diff --git a/docs/00-reference-setup.md b/docs/00-reference-setup.md index b6baa03d2..74160adf1 100644 --- a/docs/00-reference-setup.md +++ b/docs/00-reference-setup.md @@ -141,6 +141,7 @@ It downloads the new file under `clinvar/.refresh/`, checks the md5, builds both | `reference/gencode.v50.basic.genes.gtf` | the gene lines of GENCODE 50's basic annotation (md5 checked) | step 8 (gene positions for T1K) | step 8 is skipped | | `reference/gencode.v50.basic.exons.bed` | the exon intervals of the same GENCODE 50 basic annotation, written from the same download as the gene lines (md5 checked) | steps 6 and 17 and Nextflow `--gencode_exons` with `clinvar` (cDNA read check); step 39 and `--gencode_exons` with `--pedigree` (deletions over an exon) | steps 6 and 17 and `CLINVAR_CDNA_CHECK` write every hit as `not_checked`; step 39 does not use deletions | | `gnomad_mito/gnomad.genomes.v3.1.sites.chrM.vcf.bgz` | gnomAD v3.1's mitochondrial sites, about 5 MB (`GNOMAD_MITO_URL`, sha256 `GNOMAD_MITO_SHA256` in `versions.env`, checked by `setup.sh` and `validate-setup.sh`) | step 20 (gnomAD AF_hom, AF_het and max_hl beside each chrM call) | step 20 writes its annotation table with the gnomAD columns empty, and `validate-setup.sh` warns (it fails on a file whose sha256 is not the pinned one) | +| `reference/GRCh38_AllTandemRepeats.bed.gz` and its unpacked copy `reference/GRCh38_AllTandemRepeats.bed` | every GRCh38 tandem repeat of GIAB's genome stratifications v3.6 (TRF and RepeatMasker simple repeats, 5 bp added on each side), about 9 MB, NIST data free to reuse (`TANDEM_REPEATS_URL`, sha256 `TANDEM_REPEATS_SHA256` in `versions.env`, checked by `setup.sh`). Sniffles2 reads a plain BED only, so setup keeps the unpacked copy beside the download | step 04c (`sniffles --tandem-repeats`, long reads only) | step 04c prints a note and runs Sniffles2 without it: SVs inside repeats get less precise breakpoints and merging | | `reference/somalier/sites.hg38.vcf.gz` | somalier's GRCh38 sites, 17,766 SNPs (sha256 checked) | step 33 (`somalier extract`), Nextflow `--somalier_sites` | step 33 stops and says to install it | | `reference/verifybamid2/1000g.phase3.100k.b38.vcf.gz.dat.{UD,mu,bed}` | VerifyBamID2's 1000 Genomes panel of 100,000 markers, from the VerifyBamID v2.0.3 release (sha256 checked) | step 33 (`verifybamid2`), Nextflow `--verifybamid2_panel` | step 33 stops and says to install it | diff --git a/docs/live-site.md b/docs/live-site.md index d49ac0161..ea5fbd3b8 100644 --- a/docs/live-site.md +++ b/docs/live-site.md @@ -28,6 +28,8 @@ OWNGENOME_LIVE_URL=http://127.0.0.1:8788 ./scripts/run-all.sh your_name male # `./scripts/owngenome-live.sh your_name` does the same and prints the address of that run's page. `hash-password` writes `GENOME_DIR/.owngenome-live/password` with mode 600. The file holds a PBKDF2-SHA256 hash, never the password. Open http://127.0.0.1:8787, log in, and pick the run. +The site runs in the foreground of its terminal. Press Ctrl+C there to stop it. A run that posts to it goes on without it. Under the systemd unit of [Deploy it on a server](#deploy-it-on-a-server), `systemctl stop owngenome-live` stops it. + With `OWNGENOME_LIVE_URL` set, `run-all.sh` writes `/nextflow/live.config` and passes it to Nextflow with `-c`. That config loads the nf-weblog plugin (pinned as `NF_WEBLOG_PLUGIN` in `versions.env`; Nextflow downloads it on the first live run) and points it at `OWNGENOME_LIVE_URL/ingest/`, so every task's progress is posted. The numbered script steps that run after the pipeline (GRIDSS, imputation prep, the somatic caller, the extra callers) post when they start and how they end (the benchmark, `benchmark-variants.sh`, has no step number and posts nothing), and `run-all.sh` posts once more as it ends, with its exit code. A site that is down or slow costs one warning; the run never waits for it and never fails for it. `OWNGENOME_LIVE_URL` must be a plain `http://host:port` URL. Set `OWNGENOME_LIVE_PAGE_URL` to the address you open the site at (`http://127.0.0.1:8787`, or the name behind your proxy) and `run-all.sh` also prints the run's page, `OWNGENOME_LIVE_PAGE_URL/runs//`, as it starts; it prints it only together with `OWNGENOME_LIVE_URL`. A bare `nextflow run main.nf` can report too. Write a config like this one, with the sample id at the end of the URL (the page counts only the tasks tagged with it), and pass it with `-c`: @@ -82,6 +84,8 @@ The home page decides from `/runs.json` alone. A gated child is a child (the rul On the family page, chapter IV shows a gated child's buttons only, and each child opens on its own. A gated person whom this family lists as a parent or partner, because another family lists them as a child, gets their buttons under the members, after the member list. The family view gets the family without that child's report data: no de novo or compound-het rows, stretches, trio status or trio files of the child, no relationship or shared-segment row with the child, and no couple screen of a couple the child is part of (the couple keeps its names and whether it was screened; a screened couple's line says its screen stays closed). The side by side keeps a row only when an open member has a value in it, in a fixed order, and the child's cell reads "closed". Plan rows that name the child are left out. The parents' other plan rows and the couple reports of couples with no gated partner stay. Other reports of the family folder are left out while a child is gated, because they can hold the child's data. A member with no run here has no report, so the gate does not close anything of theirs. The pedigree and the members' progress stay. +The de novo candidates and the compound-het pairs of a child are read against the child and both parents: a row names the child and the parent each call or variant comes from. So both tables of a child stay out of the family view while the child or either parent is gated. That covers a family with three generations: while a person's report is closed, their children's tables in this family are closed too, because those rows hold that person's calls. Such a child keeps their entry and their stretches, and chapter IV shows one fixed line in place of the two tables: "The de novo candidates and compound-het pairs stay closed while 's report is closed: they are read against that genome." The line is the same whatever rows there are, so it gives no count and no heading of rows. Once every result to act on of that parent is opened on the page, the tables come back, as they do for a child whose own results are opened. A child with no result to act on, and no gated parent, shows every row. + The gate holds the page's `fetch` and `EventSource`. A view or plugin reads a run's files through them. `XMLHttpRequest`, an ``, an `