Database governance built for humans and agents — controlling changes and access across every major database.
Go cicddata-governancedata-maskingdata-securitydatabase-accessdatabase-governancedevopsdevsecopsflywaygitopsliquibasemongodbmysqloraclepostgresqlschema-migrationssecuritysql-clientsqlservertidb
docs(design): correct the expansion claim and show the transitions
zchpeter4bba38eee20c
diff --git a/docs/design/task-run-log-previous-attempts.md b/docs/design/task-run-log-previous-attempts.mdindex 8cb47d9bab..5e1162c513 100644--- a/docs/design/task-run-log-previous-attempts.md+++ b/docs/design/task-run-log-previous-attempts.md@@ -195,6 +195,8 @@ Re-running a failed task therefore does **not** put the old run into Previousattempts; it starts a new run whose log begins empty, and the failed run movesinto the history sheet with its own log intact.++The two are easy to conflate, and the labels should carry the difference ratherthan leave it to be inferred: the history button reads "History (3)" today, whichnames no level. Renaming it "Previous runs (3)" pairs it with "Previous attempts"@@ -214,6 +216,8 @@ work.| Run reaches a terminal status | the viewer remounts — its key carries the status — so everything returns to defaults | acceptable, because collapsed *is* the default || Someone clicks Re-run | a new `task_run`; the viewer remounts on the new name with no umbrella; the finished run moves to the history sheet | not a retry, and not this row's business |++Two existing behaviors compose with this without special handling, and are worthstating so nobody adds handling they do not need. When a task run moved betweenreplicas, every replica group but the last has its still-running sections forced@@ -225,27 +229,30 @@ an older run shows its own umbrella derived from its own entries.### What must survive a poll-Expansion state does not survive one today. `resolvedDatasetKey` in-`useTaskRunLogSections.ts` is built from every entry in the log, and its effect-clears every expansion set whenever that key changes — which, on a live run, is-every time an entry arrives. Section ids compound it: they are positional-(`section-${index}`), so inserting an attempt boundary renumbers every section-after it.+Expansion state already survives one. `TaskRunLogViewer` passes+`datasetKey: taskRunName` into `useTaskRunLogSections`, and `resolvedDatasetKey`+returns that before it considers the entries, so the reset fires when the viewer+shows a different task run and not when entries are appended. The entry-derived+fallback in that hook is dead code for this consumer. Nothing about the reset+needs changing.++What does not survive is the **identity of a section**. Ids are positional —+`section-${index}` — while expansion is a set of those ids. Inserting an attempt+boundary regroups the list, so a section's index changes while the set still holds+the old one. The expansion then lands on whichever section now occupies that+index: the row the reader opened closes, and an unrelated row opens in its place.-Both are survivable today because a live log is watched more than it is read. This-change ends that: the reason to open a superseded attempt is to read the error-that caused the retry, and retries happen *while the run is still streaming*. As-it stands, the row a reader just opened would close under them within five-seconds, and under positional ids could reopen as a different section entirely.+That is worse than it sounds, because the regrouping happens at exactly the moment+a reader has a reason to be reading. The first `RETRY_INFO` folds every earlier+section into the umbrella and renumbers everything after it, in one poll, while+the run is still streaming.-So this design depends on two fixes, both in the grouping layer:+So this design depends on one fix in the grouping layer: derive a section's id+from what it is — its scope, attempt ordinal, entry type, and first entry's+timestamp — rather than from its position. Ids then survive regrouping, and+expansion follows the section it belongs to.-- **Stable ids.** Derive a section's id from what it is — its scope, attempt- ordinal, entry type, and first entry's timestamp — rather than from its index.-- **A narrower reset.** Reset expansion only when the log's identity changes, that- is, when the viewer is showing a different task run. With stable ids an append- needs no reset at all: sections that did not exist before are simply absent from- the expanded set.+## Alternatives rejected@@ -278,20 +285,18 @@ Implementation follows in a separate PR, after #21417 lands.contains, with the entries themselves untouched.- `useTaskRunLogSections.ts`: a third grouping layer alongside the replica andrelease-file layers, and auto-expand restricted to error sections outside the- superseded attempts. Also the two transition fixes — content-derived section- ids in place of positional ones, and an expansion reset keyed to the task run- rather than to every appended entry — without which an opened attempt closes on- the next poll.+ superseded attempts. Also content-derived section ids in place of positional+ ones, without which regrouping at the first marker moves a reader's expansion+ onto a different section.- `TaskRunLogViewer.tsx` and `SectionHeader.tsx`: the umbrella and nested-attemptrows, plus locale keys for the labels.- Tests mirror the truth table and the cutting cases: no marker, one marker,several markers, a marker inside a release-file group, several release-filegroups retrying different numbers of times, replica-grouped entries, an emptyfinal segment, and a prior-backup section that must stay outside attempt 1.- Transition coverage appends entries to a rendered log and asserts that ids hold- and an opened attempt stays open across the append, that the first marker folds- the earlier sections without disturbing the streaming segment, and that a- different task run does reset the view.+ Transition coverage asserts that a section keeps its id across the regrouping+ the first marker causes, so an expanded section stays the expanded one, and that+ the marker folds the earlier sections without disturbing the streaming segment.### Building on #21417diff --git a/docs/design/task-run-log-previous-attempts/01-today.png b/docs/design/task-run-log-previous-attempts/01-today.pngindex f5ec3db068..6b1a335f8e 100644Binary files a/docs/design/task-run-log-previous-attempts/01-today.png and b/docs/design/task-run-log-previous-attempts/01-today.png differdiff --git a/docs/design/task-run-log-previous-attempts/02-no-retry.png b/docs/design/task-run-log-previous-attempts/02-no-retry.pngindex f1a29f9aa7..c87e114ac7 100644Binary files a/docs/design/task-run-log-previous-attempts/02-no-retry.png and b/docs/design/task-run-log-previous-attempts/02-no-retry.png differdiff --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.pngindex 83429f10e3..cbe5363bb1 100644Binary 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 differdiff --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.pngindex 53e5c9dab2..86c30a17d1 100644Binary 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 differdiff --git a/docs/design/task-run-log-previous-attempts/05-multiple-attempts-collapsed.png b/docs/design/task-run-log-previous-attempts/05-multiple-attempts-collapsed.pngindex 4c10805a46..657477f830 100644Binary files a/docs/design/task-run-log-previous-attempts/05-multiple-attempts-collapsed.png and b/docs/design/task-run-log-previous-attempts/05-multiple-attempts-collapsed.png differdiff --git a/docs/design/task-run-log-previous-attempts/06-multiple-attempts-expanded.png b/docs/design/task-run-log-previous-attempts/06-multiple-attempts-expanded.pngindex 8c284711d3..b384aa8ef6 100644Binary files a/docs/design/task-run-log-previous-attempts/06-multiple-attempts-expanded.png and b/docs/design/task-run-log-previous-attempts/06-multiple-attempts-expanded.png differdiff --git a/docs/design/task-run-log-previous-attempts/07-failed-and-running.png b/docs/design/task-run-log-previous-attempts/07-failed-and-running.pngindex 7547411c0a..994d3a0079 100644Binary files a/docs/design/task-run-log-previous-attempts/07-failed-and-running.png and b/docs/design/task-run-log-previous-attempts/07-failed-and-running.png differdiff --git a/docs/design/task-run-log-previous-attempts/08-alternatives-rows-and-lanes.png b/docs/design/task-run-log-previous-attempts/08-alternatives-rows-and-lanes.pngindex 0012fd044f..089dbf486a 100644Binary files a/docs/design/task-run-log-previous-attempts/08-alternatives-rows-and-lanes.png and b/docs/design/task-run-log-previous-attempts/08-alternatives-rows-and-lanes.png differdiff --git a/docs/design/task-run-log-previous-attempts/09-alternative-status-only.png b/docs/design/task-run-log-previous-attempts/09-alternative-status-only.pngindex 320f50e8f4..d1c16bb5a0 100644Binary files a/docs/design/task-run-log-previous-attempts/09-alternative-status-only.png and b/docs/design/task-run-log-previous-attempts/09-alternative-status-only.png differdiff --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.pngindex 590352daa6..506491c3fc 100644Binary 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 differdiff --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.pngnew file mode 100644index 0000000000..6353a8de22Binary files /dev/null and b/docs/design/task-run-log-previous-attempts/11-transition-first-retry.png differdiff --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.pngnew file mode 100644index 0000000000..9e201036b4Binary files /dev/null and b/docs/design/task-run-log-previous-attempts/12-transition-expansion-follows-section.png differdiff --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.pngnew file mode 100644index 0000000000..ed99145e4fBinary files /dev/null and b/docs/design/task-run-log-previous-attempts/13-transition-retry-vs-rerun.png differ