Skip to content

Database governance built for humans and agents — controlling changes and access across every major database.

docs(design): define what the summary counts

zchpeter478eedb0a634
diff --git a/docs/design/task-run-log-previous-attempts.md b/docs/design/task-run-log-previous-attempts.md
index 764963c565..015405f12b 100644
--- a/docs/design/task-run-log-previous-attempts.md
+++ b/docs/design/task-run-log-previous-attempts.md
@@ -149,8 +149,15 @@ produces a `RETRY_INFO`, and the gh-ost path never calls `driver.Execute` at all
- **Durations.** An attempt's duration is its span; the umbrella's duration is the
sum of its attempts' spans. One-time sections keep their own durations and are
counted in neither.
-- The "N sections · M entries" summary keeps counting everything, superseded
- attempts included.
+- **Summary counts.** The summary describes rendered rows, so that expanding
+ everything and counting agrees with it. Sections are the leaf sections, across
+ every attempt including superseded ones; grouping rows are not sections, which
+ is already true of the replica and release-file headers that `totalSections`
+ skips today. Entries are the entries inside those sections, so a `RETRY_INFO`
+ consumed as a boundary counts as neither — a one-retry run therefore reports one
+ section and one entry fewer than it does today, with nothing else moved. Start
+ and end pairs such as `DATABASE_SYNC` and `PRIOR_BACKUP` are merged into one
+ entry by the API converter and count once.
- Frontend-only. Scopes and boundaries derive entirely from entries already in the
stream, so no proto or backend change is required.
diff --git a/docs/design/task-run-log-previous-attempts/03-one-attempt-collapsed.png b/docs/design/task-run-log-previous-attempts/03-one-attempt-collapsed.png
index cbe5363bb1..2658254850 100644
Binary files a/docs/design/task-run-log-previous-attempts/03-one-attempt-collapsed.png and b/docs/design/task-run-log-previous-attempts/03-one-attempt-collapsed.png differ
diff --git a/docs/design/task-run-log-previous-attempts/04-one-attempt-expanded.png b/docs/design/task-run-log-previous-attempts/04-one-attempt-expanded.png
index 86c30a17d1..8903543ad9 100644
Binary files a/docs/design/task-run-log-previous-attempts/04-one-attempt-expanded.png and b/docs/design/task-run-log-previous-attempts/04-one-attempt-expanded.png differ
diff --git a/docs/design/task-run-log-previous-attempts/10-one-time-sections-outside.png b/docs/design/task-run-log-previous-attempts/10-one-time-sections-outside.png
index 506491c3fc..463080f554 100644
Binary files a/docs/design/task-run-log-previous-attempts/10-one-time-sections-outside.png and b/docs/design/task-run-log-previous-attempts/10-one-time-sections-outside.png differ
diff --git a/docs/design/task-run-log-previous-attempts/11-transition-first-retry.png b/docs/design/task-run-log-previous-attempts/11-transition-first-retry.png
index 6353a8de22..774bfee390 100644
Binary files a/docs/design/task-run-log-previous-attempts/11-transition-first-retry.png and b/docs/design/task-run-log-previous-attempts/11-transition-first-retry.png differ
diff --git a/docs/design/task-run-log-previous-attempts/12-transition-expansion-follows-section.png b/docs/design/task-run-log-previous-attempts/12-transition-expansion-follows-section.png
index 9e201036b4..4c684a4af4 100644
Binary files a/docs/design/task-run-log-previous-attempts/12-transition-expansion-follows-section.png and b/docs/design/task-run-log-previous-attempts/12-transition-expansion-follows-section.png differ
diff --git a/docs/design/task-run-log-previous-attempts/13-transition-retry-vs-rerun.png b/docs/design/task-run-log-previous-attempts/13-transition-retry-vs-rerun.png
index ed99145e4f..3346dea431 100644
Binary files a/docs/design/task-run-log-previous-attempts/13-transition-retry-vs-rerun.png and b/docs/design/task-run-log-previous-attempts/13-transition-retry-vs-rerun.png differ