# Pipeline detail Graph tab — pinned definition wiring Candidate for the graph-tab slice. All work is under `app/`; no commit, push, deployment or production mutation was made. ## Implemented - `PipelineDetail` retains `graph` and optional `shape` as raw JSON from the reply. Source, versions and every existing field keep their previous parsing; an absent graph stays `null` rather than becoming an empty definition. - The detail panel gives its tabs the remaining bounded height: Summary and Source scroll inside that slot, the Graph tab fills it. - `PipelineGraphTab` renders the landed `DefinitionGraphView` (measured nodes, routed edges/labels, stock pan/zoom) and the web's guidance vocabulary adapted to host gestures. Selecting any node, including `Success`/`Failure`, opens the landed `openStageDefinition` pane with the pinned pipeline id, name and resolved version. No run status or visited styling is read. - The selected node key lives in `PipelineDetailPanel`, not in the tab, so a Summary/Source round trip keeps the mark (the web keeps its `pipelineGraphSelection` across in-place tab changes). A different pipeline or resolved version clears it, including an in-place reconnect reload that keeps a detail rather than nulling it. - A reply without `graph` states that the definition is missing and draws nothing. Empty definitions still get `This pipeline has no stages.` from the graph view. - The obsolete P2 `graphBuilder`/`PipelineStageRef` hook and its pending-state test were removed; the production shell never supplied one. ## Bounded-height fix (review must-fix) The first candidate made the guidance note a fixed child above `Expanded(DefinitionGraphView)`. When the tab slot was shorter than the note, the column overflowed and the canvas was laid out at 0 height (390x600 @2x, 1100x400 @2x, 1100x900 @3x), and the note also took most of the slot at 390x844 @2x. - `PipelineGraphTab` now measures the slot with `LayoutBuilder` and caps the note at `pipelineGraphNoteShare` (one third). A note longer than its share scrolls inside it, so the canvas always keeps at least two thirds and can never be zero. At ordinary sizes the note keeps its natural height. - `PipelineDetailPanel` keeps a `kPipelineDetailMinContentHeight` reserve for the selected tab and lets the header/banners/tabs scroll when a very short panel (for example 390x300 @3x) would otherwise squeeze the tab away. Normal sizes keep the header's natural height. - Regression tests cover 390x844 @2x, 390x600 @2x, 1100x400 @2x, 1100x900 @3x, an empty definition in a 200 px slot, and the 390x300 @3x panel header. - The test fixture now pins a distinct v1 graph, so the version-switch test proves the mark is cleared rather than reusing the newer definition. ## Checks - `flutter analyze` — no issues. - `flutter test test/features/pipelines test/features/graph` — 198 pass. - `flutter test` — 788 pass. - `flutter build web` — pass. - Review repro (`public/review/graph_tab_overflow_repro_test.dart`): all 4 cases now pass, including the three that failed before the fix. - Browser fixture (`tool/pipeline_graph_tab_probe.dart`, `tool/pipeline_graph_tab_probe.mjs`), actual `PipelinesScreen` with the in-memory fixture gateway, dark, both hosts, at 1280x900 @2x, plus Material at 390x844 @2x, 390x600 @2x and 1100x900 @3x: every run 4 checks and 3 PNG captures. Captures and JSON: `/Users/alan/.local/share/pipelines/data/artifacts/85/public/pipeline-graph-tab-probe-fixed/` - Not verified: live authenticated server, Android/iOS builds or devices, shell URL routing for graph selection. Initial fit-to-viewport is not implemented (the web auto-fits on mount); pan/zoom and the guidance note cover discovering off-screen nodes, and the now-larger canvas keeps more of the graph in view. ## Manager completion after the Code deadline The last Code visit reached its deadline while active; the retained tree is complete and its pipelines suite passes (62 tests), including the 390x844/2x, short-slot and pinned-definition cases. Manager merged it directly: the Graph tab now renders the measured definition canvas in a bounded slot and opening a node shows its authored definition for the pinned version. No run evidence is implied.