proctolog 0.1.0

data/app/views/proctolog/open_pull_requests/index.html.erb

@@ -0,0 +1,106 @@
+<% content_for :title, "Bursts and pull requests" %>
+<% content_for :side do %>
+  <%= render "side", bursts: @bursts, read_at: @read_at %>
+<% end %>
+<% content_for :head do %>
+  <link rel="stylesheet" href="/pick.css">
+<% end %>
+
+<header class="burst">
+  <h1>Bursts and pull requests</h1>
+  <p class="lede">
+    Pick what to review. A pull request opens alone, a stack opens whole, and the ones you tick open together.
+    GitHub read <%= tag.time read_at_in_words(@read_at), datetime: @read_at.iso8601 %> · <%= link_to "read again", open_pull_requests_path(fresh: 1) %>
+  </p>
+</header>
+
+<main class="route pick">
+  <% if @bursts.any? || @put_away.any? %>
+    <h2>Your bursts</h2>
+    <ol class="lines">
+      <% (@put_away_shown ? @bursts + @put_away : @bursts).each do |burst| %>
+        <li>
+          <p class="what"><%= link_to burst.name, burst_path(burst.slug), class: "title" %></p>
+          <p class="facts"><%= burst.slug %> · <%= burst.own? ? "yours" : "the repository's" %><%= put_away_in_words(burst) %></p>
+        </li>
+      <% end %>
+    </ol>
+    <% if @put_away.any? %>
+      <p class="hint">
+        <% if @put_away_shown %>
+          <%= link_to "Put them away again", open_pull_requests_path %>
+        <% else %>
+          <%= pluralize(@put_away.size, "burst") %> put away, finished or done with. <%= link_to "Show #{(@put_away.size == 1) ? "it" : "them"}", open_pull_requests_path(put_away: 1) %>
+        <% end %>
+      </p>
+    <% end %>
+  <% end %>
+
+  <% if @pick.empty? %>
+    <p class="lede">Nothing is open in <%= @repository %>.</p>
+  <% end %>
+
+  <% @pick.stacks.each do |stack| %>
+    <h2>Stack #<%= stack.number %>, <%= stack.pull_requests.size %> from the bottom up</h2>
+    <%= button_to "Review the stack", review_stack_path(stack.number), class: "quiet" %>
+    <ol class="lines">
+      <% stack.pull_requests.each do |pull_request| %>
+        <li>
+          <p class="what">
+            <%= link_to "##{pull_request.number}", pull_request.url, class: "number", target: "_blank", rel: "noopener" %>
+            <span class="title"><%= pull_request.title %></span>
+          </p>
+          <p class="facts"><%= pick_facts(@pick, pull_request) %></p>
+          <%= button_to "Review alone", alone_open_pull_request_path(pull_request.number), class: "quiet" %>
+        </li>
+      <% end %>
+    </ol>
+  <% end %>
+
+  <% if (loose = @pick.loose).any? %>
+    <h2><%= @pick.stacks.any? ? "In no stack" : "Pull requests" %></h2>
+    <%= form_with url: bursts_path, method: :post do |form| %>
+      <ol class="lines">
+        <% loose.each do |pull_request| %>
+          <li>
+            <p class="what">
+              <%= check_box_tag "tops[]", pull_request.number, false, id: "pick-#{pull_request.number}", aria: {label: "Review ##{pull_request.number} together with the others ticked"} %>
+              <%= link_to "##{pull_request.number}", pull_request.url, class: "number", target: "_blank", rel: "noopener" %>
+              <%= label_tag "pick-#{pull_request.number}", pull_request.title, class: "title" %>
+            </p>
+            <p class="facts"><%= pick_facts(@pick, pull_request) %></p>
+            <%= form.button "Review alone", formaction: alone_open_pull_request_path(pull_request.number), class: "quiet" %>
+          </li>
+        <% end %>
+      </ol>
+      <p class="together">
+        <%= form.label :slug, "Together, as" %>
+        <%= form.text_field :slug, placeholder: "named after the first one's branch", pattern: "[a-z0-9]+(-[a-z0-9]+)*", autocomplete: "off" %>
+        <%= form.button "Review the ticked together", class: "primary" %>
+      </p>
+      <p class="hint">A ticked pull request brings the chain under it, followed down by base branches.</p>
+    <% end %>
+  <% end %>
+
+  <% if @pick.unopened.any? %>
+    <h2>Not opened</h2>
+    <p class="hint">Branches of this Mac with a description written for them, which nobody has opened on GitHub yet. A burst names each by its branch, so it still holds once it is opened.</p>
+    <ol class="lines">
+      <% @pick.unopened.each do |pull_request| %>
+        <li>
+          <p class="what">
+            <span class="number">#<%= pull_request.number %></span>
+            <span class="title"><%= pull_request.title %></span>
+          </p>
+          <p class="facts"><%= unopened_facts(pull_request) %></p>
+          <div class="actions">
+            <%= button_to "Review alone", alone_open_pull_request_path(pull_request.number), class: "quiet" %>
+            <% if @pick.chained?(pull_request) %>
+              <%= button_to "Review the chain", chain_open_pull_request_path(pull_request.number), class: "quiet" %>
+            <% end %>
+          </div>
+        </li>
+      <% end %>
+    </ol>
+  <% end %>
+</main>

data/app/views/proctolog/prompts/show.html.erb

@@ -0,0 +1,41 @@
+<% content_for :title, "The prompt · #{@burst.name}" %>
+<% content_for :head do %>
+  <link rel="stylesheet" href="/prompt.css">
+  <link rel="stylesheet" href="/respond.css">
+  <link rel="stylesheet" href="/decisions.css">
+  <script type="module" src="/prompt.js"></script>
+<% end %>
+<% content_for :mode, mode_line("Returned work", "j k" => "move", "a" => "confirm", "q" => "answer or ask", "c" => "correction", "l" => "later", "e" => "handover") %>
+<% content_for :keys do %>
+  <%= keys_group "Returned work", "j k" => "move", "Home End" => "first, last", "a" => "confirm", "q" => "answer or ask", "c" => "correction", "l" => "later", "d" => "its changes in Diffle" %>
+  <%= keys_group "Write", "⌘ Enter" => "save the reply", "Esc" => "close" %>
+  <%= keys_group "This burst", "e" => "handover" %>
+<% end %>
+
+<header class="burst">
+  <h1>The prompt</h1>
+  <% if @handover.empty? %>
+    <p class="tally">Nothing waits for the agent: no choice, note or code comment of yours, and no unresolved thread on GitHub.</p>
+  <% else %>
+    <p class="tally"><%= handed_over(@handover).upcase_first %> would be handed over, from the bottom of the stack up.</p>
+  <% end %>
+</header>
+
+<%= render "proctolog/decisions/draft_tools", burst: @burst %>
+<script type="application/json" id="decision-inventory"><%= raw json_escape(decision_inventory(@burst)) %></script>
+<%= render "proctolog/decisions/round_data", burst: @burst %>
+<section class="round-results" data-round-results aria-label="Agent responses"></section>
+<pre class="handover" data-combined-handover></pre>
+
+<% if @taken_in.any? %>
+  <p class="taken-in">An agent's report moved <%= pluralize(@taken_in.size, "note") %> to "addressed": <%= @taken_in.map(&:id).to_sentence %>. They are yours to confirm.</p>
+<% end %>
+
+<% @burst.reports.unreadable.each do |report| %>
+  <p class="unreadable">The report <code><%= report %></code> is not a list of entries, and was not taken in.</p>
+<% end %>
+
+<% @burst.reports.unmatched.each do |entry| %>
+  <p class="unreadable">The report <code><%= entry.report %></code> names <code><%= entry.note %></code>, which is no note of this burst. It was not taken in.</p>
+<% end %>
+

data/app/views/proctolog/pull_requests/_connections.html.erb

@@ -0,0 +1,65 @@
+<%# locals: (burst:, route:, stop:) %>
+<% shared = by_overlap(route.sharing_files_with(stop)) %>
+<% named = route.named_by(stop) %>
+
+<section class="connections" aria-label="How it connects">
+  <dl>
+    <div>
+      <dt>Rests on</dt>
+      <dd>
+        <% if (under = route.under(stop)) %>
+          <%= pull_request_link(burst, under) %>
+        <% else %>
+          the <code><%= stop.pull_request.base %></code> branch
+        <% end %>
+      </dd>
+    </div>
+    <div>
+      <dt>Rests on it</dt>
+      <dd>
+        <% if (over = route.over(stop)) %>
+          <%= pull_request_link(burst, over) %>
+        <% else %>
+          nothing
+        <% end %>
+      </dd>
+    </div>
+    <div>
+      <dt>Changes the same files as</dt>
+      <dd>
+        <% if shared.empty? %>
+          no other pull request
+        <% else %>
+          <ul class="sharing">
+            <% shared.each do |other, files| %>
+              <li>
+                <details>
+                  <summary><%= pull_request_link(burst, other) %> <span class="count"><%= pluralize(files.size, "file") %></span></summary>
+                  <ul class="files">
+                    <% files.each do |file| %>
+                      <li><code><%= file %></code></li>
+                    <% end %>
+                  </ul>
+                </details>
+              </li>
+            <% end %>
+          </ul>
+        <% end %>
+      </dd>
+    </div>
+    <div>
+      <dt>Names</dt>
+      <dd>
+        <% if named.empty? %>
+          no other pull request
+        <% else %>
+          <ul class="named">
+            <% named.each do |other| %>
+              <li><%= pull_request_link(burst, other) %></li>
+            <% end %>
+          </ul>
+        <% end %>
+      </dd>
+    </div>
+  </dl>
+</section>

data/app/views/proctolog/pull_requests/_finish.html.erb

@@ -0,0 +1,42 @@
+<%# Where a pull request's decisions end: what is reviewed, what to do next, each by its key, and alone on the page every decision on a line under its grade, which the script marks with what was chosen or what holds it. A line unfolds to the decision's own words and the choice in full. j and k go down the lines, → and ← unfold and fold one, and Enter opens it to decide. Under the page the decisions themselves are just above, so the lines stay away. %>
+<% graded = boxes.any? { !it.decision.blocking? } %>
+<div class="finish" data-finish data-desk tabindex="-1" hidden>
+  <p><strong data-finish-said>Every decision of this pull request is reviewed.</strong></p>
+  <p class="actions">
+    <% if !standing.good_to_go? || standing.changed? %>
+      <button type="button" class="quiet" data-finish-good>Good to go <kbd>g</kbd></button>
+    <% end %>
+    <% if next_to_review %>
+      <%= link_to burst_pull_request_path(burst, next_to_review.number), title: next_to_review.title do %>Next to review #<%= next_to_review.number %> <kbd>N</kbd><% end %>
+    <% elsif later %>
+      <%= link_to burst_pull_request_path(burst, later.number), title: later.title do %>#<%= later.number %> → <kbd>J</kbd><% end %>
+    <% end %>
+    <button type="button" class="quiet" data-finish-handover>Hand over <kbd>e</kbd></button>
+    <%= link_to burst_path(burst, anchor: "pr-#{stop.number}") do %>Route <kbd>h</kbd><% end %>
+  </p>
+  <% boxes.group_by { it.decision.grade }.each do |grade, of_grade| %>
+    <section class="grade">
+      <h3><%= graded ? grade_named(grade).name : "Decisions" %> <span class="count" data-grade-count></span></h3>
+      <% if graded %>
+        <p class="meaning"><%= grade_named(grade).meaning %></p>
+      <% end %>
+      <% unless grade == :blocking %>
+        <p class="leave" data-finish-leave hidden>
+          <button type="button" class="quiet" data-leave-non-blocking data-pr="<%= stop.number %>" hidden><kbd>A</kbd> <span data-leave-said></span></button>
+          <span data-held-said></span>
+        </p>
+      <% end %>
+      <ol class="lines">
+        <% of_grade.each do |box| %>
+          <%= tag.li tabindex: -1, aria: {expanded: false}, data: {line_of: box.to_param, reading: ""} do %>
+            <span class="bead" aria-hidden="true"></span><span class="lead"><%= box.plain_lead %></span><span class="said" data-line-said></span>
+            <div class="more">
+              <div class="words"><%= raw decision_html(box, burst) %></div>
+              <p class="choice" data-line-choice></p>
+            </div>
+          <% end %>
+        <% end %>
+      </ol>
+    </section>
+  <% end %>
+</div>

data/app/views/proctolog/pull_requests/_margin.html.erb

@@ -0,0 +1,33 @@
+<%# locals: (rendering:, burst:, stop:) %>
+<aside class="margin" aria-label="Notes">
+  <% if rendering.about.any? %>
+    <h3>On the whole pull request</h3>
+    <ol class="cards">
+      <% rendering.about.each do |note| %>
+        <%= render "note", note:, rendering:, burst:, stop: %>
+      <% end %>
+    </ol>
+  <% end %>
+
+  <% if rendering.margin.any? %>
+    <h3>On the description</h3>
+    <ol class="cards">
+      <% rendering.margin.each do |note| %>
+        <%= render "note", note:, rendering:, burst:, stop: %>
+      <% end %>
+    </ol>
+  <% elsif rendering.about.none? %>
+    <p class="empty">No notes yet. Select some words, press the + beside a block, or drag across a picture.</p>
+  <% end %>
+
+  <% if rendering.set_aside.any? %>
+    <details class="set-aside">
+      <summary>Put away <span class="count"><%= rendering.set_aside.size %></span></summary>
+      <ol class="cards">
+        <% rendering.set_aside.each do |note| %>
+          <%= render "note", note:, rendering:, burst:, stop: %>
+        <% end %>
+      </ol>
+    </details>
+  <% end %>
+</aside>

data/app/views/proctolog/pull_requests/_note.html.erb

@@ -0,0 +1,4 @@
+<%# locals: (note:, rendering:, burst:, stop:) %>
+<%# A note with a mark on the page is found by its mark; one without is found by its card. The card keeps the words as written, for the picture viewer to open the note again. %>
+<%= render "proctolog/notes/card", note:, burst:, stop:, where: place_of(note, rendering),
+      attributes: {id: ("note-#{note.id}" unless rendering.margin.include?(note)), data: {card: note.id, text: note.text}} %>

data/app/views/proctolog/pull_requests/_outline.html.erb

@@ -0,0 +1,26 @@
+<%# locals: (rendering:, standing:, scenarios:, open_notes:, burst:, code:) %>
+<%# The outline beside the page: its sections in the page's own order, the one the reading is in marked by the script, and a count only where something waits for the owner (the pictures of Screenshots are the one count that merely informs). A press goes to the section. The script pairs each line with a section of the page by its place, so the two lists keep the same order. data-desk keeps it out of the reading order. %>
+<nav class="outline" aria-label="In this pull request" data-outline data-desk>
+  <% rendering.sections.each do |section| %>
+    <% if section.heading == Proctolog::Description::DECISIONS %>
+      <%= outline_line "Decisions", waits_for: "decisions" %>
+    <% elsif section.heading == "Screenshots" %>
+      <%= outline_line section.heading, count: section.figures.size %>
+    <% else %>
+      <%= outline_line section.heading || "Opening" %>
+    <% end %>
+  <% end %>
+  <%= outline_line "Standing", count: "#{standing.judged.count(&:met)}/#{standing.judged.size}", waits: standing.judged.any? { !it.met }, apart: true %>
+  <%# Scenarios are counted, but never wait for the owner: a pull request can go without them. %>
+  <% if scenarios.any? %>
+    <% seen = scenarios.count { standing.marks.scenarios.dig(it.name, "head") == standing.stop.head_oid } %>
+    <%= outline_line "Scenarios", count: "#{seen}/#{scenarios.size}" %>
+  <% end %>
+  <%= outline_line "Connections" %>
+  <%= outline_line "Notes", count: open_notes.nonzero?, waits: true %>
+  <%= outline_line "Handover" %>
+  <%# What Diffle holds of it: the comments nobody resolved, which wait for the handover, and the files marked viewed once code has opened. Diffle goes on in a tab of its own, so code-review.js asks again whenever the owner comes back to this one. Both lines go to the Code comments page. %>
+  <% comments = burst_pull_request_code_review_path(burst, standing.stop.number) %>
+  <%= outline_line "Code comments", to: comments, count: code.open.nonzero?, waits: true, apart: true, data: {code_tally: burst_pull_request_code_review_path(burst, standing.stop.number, format: :json)} %>
+  <%= outline_line "Files viewed", to: comments, count: ("#{code.viewed}/#{code.files}" if code.files), hidden: code.files.nil?, data: {files_viewed: ""} %>
+</nav>

data/app/views/proctolog/pull_requests/_paragraphs.html.erb

@@ -0,0 +1,9 @@
+<%# locals: (kind:, paragraphs:) %>
+<% if paragraphs.any? %>
+  <%= tag.details class: ["paragraphs", kind], open: paragraphs.size <= 12 do %>
+    <summary><%= pluralize(paragraphs.size, "paragraph") %> <%= kind %></summary>
+    <% paragraphs.each do |text| %>
+      <pre><%= text %></pre>
+    <% end %>
+  <% end %>
+<% end %>

data/app/views/proctolog/pull_requests/_scenarios.html.erb

@@ -0,0 +1,16 @@
+<%# locals: (stop:, scenarios:, marks:, burst:) %>
+<%# What each scenario asks, and what was seen of it. Try it, beside the page, starts the app and sets each one up. A press on one of the buttons comes back here with a message: open on it, so the message is seen. %>
+<% seen = scenarios.count { marks.scenarios.dig(it.name, "head") == stop.head_oid } %>
+<%= tag.details id: "scenarios", class: "section pr-scenarios", open: flash.any?, data: {heading: "Scenarios"} do %>
+  <summary>
+    <span class="heading">Scenarios</span>
+    <%# Counted, but not waiting on the owner: a pull request can go without its scenarios. %>
+    <%= tag.span "#{seen} of #{scenarios.size} seen on this head", class: "count" %>
+  </summary>
+
+  <ol class="steps-of">
+    <% scenarios.each do |scenario| %>
+      <%= render "proctolog/scenarios/scenario", scenario:, burst:, steps: scenario.steps_in(stop.description), head: stop.head_oid, seen: marks.scenarios[scenario.name], notes: scenario.noted_in(marks), overlays: marks.overlays_of(scenario.name) %>
+    <% end %>
+  </ol>
+<% end %>

data/app/views/proctolog/pull_requests/_since.html.erb

@@ -0,0 +1,42 @@
+<%# locals: (since:, stop:) %>
+<section class="since" id="since" aria-labelledby="since-heading">
+  <h2 id="since-heading">Changed since your mark</h2>
+
+  <% if (code = since.code) %>
+    <div class="code">
+      <h3>The code</h3>
+      <p>From <%= short(code.from) %> to <%= short(code.to) %>. <%= link_to "Compare on GitHub", code.compare_url, target: "_blank", rel: "noopener" if code.compare_url %></p>
+      <% if code.absent.any? %>
+        <p class="absent">This Mac does not have <%= safe_join(code.absent.map { short(it) }, " or ") %>, so it cannot say which files differ. GitHub's comparison can.</p>
+      <% elsif code.files.empty? %>
+        <p class="none">The files of this pull request are the same in both: the head moved with the layers under it.</p>
+      <% else %>
+        <% gone = code.files.count { code.dropped?(it) } %>
+        <p class="sum"><%= pluralize(code.files.size, "file") %> differ between the two heads<%= ", #{gone} of them no longer part of this pull request" if gone.positive? %>.</p>
+        <ul class="files-changed">
+          <% code.files.each do |file| %>
+            <li>
+              <span class="path"><code><%= file.path %></code><% if code.dropped?(file) %> <small class="dropped">no longer part of this pull request</small><% end %></span>
+              <span class="lines"><%= lines_of(file) %></span>
+            </li>
+          <% end %>
+        </ul>
+      <% end %>
+    </div>
+  <% end %>
+
+  <% if (description = since.description) %>
+    <div class="words">
+      <h3>The description</h3>
+      <% if description.is_a?(Proctolog::Since::Forgotten) %>
+        <p class="absent">GitHub's history no longer holds the revision of <%= clock(description.at) %>, the one you marked, so it cannot say what changed.</p>
+      <% elsif description.unchanged? %>
+        <p class="none">No paragraph differs from the revision of <%= clock(description.at) %>: only spacing changed.</p>
+      <% else %>
+        <p>Against the revision of <%= clock(description.at) %>, the one you marked.</p>
+        <%= render "paragraphs", kind: "removed", paragraphs: description.removed %>
+        <%= render "paragraphs", kind: "added", paragraphs: description.added %>
+      <% end %>
+    </div>
+  <% end %>
+</section>

data/app/views/proctolog/pull_requests/_standing.html.erb

@@ -0,0 +1,51 @@
+<%# locals: (burst:, stop:, standing:) %>
+<%# What should hold before the pull request goes, a bead to each, then whether its scenarios were tried, which is said but never required. Under them the owner's two marks, each saying what it does. The conditions inform the mark; none of them keeps it from being given. %>
+<section class="standing" aria-label="What should hold before it goes">
+  <ul class="conditions">
+    <% standing.conditions.each do |condition| %>
+      <%= tag.li data: {met: condition.met.inspect, about: condition.about} do %>
+        <span class="verdict visually-hidden"><%= verdict_of(condition) %>:</span>
+        <span class="name"><%= condition.name %></span>
+        <span class="detail"><%= with_code(condition.detail) %></span>
+      <% end %>
+    <% end %>
+    <% if (scenarios = standing.scenarios_seen) %>
+      <%= tag.li class: "optional", data: {met: scenarios.met.inspect} do %>
+        <span class="name"><%= scenarios.name %></span>
+        <span class="detail"><%= scenarios.detail %> · not required</span>
+      <% end %>
+    <% end %>
+  </ul>
+
+  <%# The owner's mark. g presses it from anywhere on the page. %>
+  <% marks = standing.marks %>
+  <div class="good-to-go">
+    <% if !standing.good_to_go? || standing.changed? %>
+      <%= button_to burst_pull_request_good_to_go_path(burst, stop.number), params: {head: stop.head_oid, description: stop.description.digest},
+            form: {data: {good_to_go: ""}} do %><kbd>g</kbd> Good to go<% end %>
+      <span class="hint">Your mark that it can go as it is now: <%= short(stop.head_oid) %> and this description.</span>
+    <% end %>
+    <% if standing.good_to_go? %>
+      <span class="hint">Good to go since <%= clock(marks.good_to_go.at) %>, for <%= short(marks.good_to_go.head) %>.</span>
+      <%= button_to "Take it back", burst_pull_request_good_to_go_path(burst, stop.number), method: :delete, class: "quiet" %>
+    <% end %>
+  </div>
+
+  <%# Set aside: while it waits on something outside the burst, the route counts it as waiting rather than as the owner's turn. %>
+  <% if marks.waiting_on %>
+    <div class="waiting">
+      <p>Waiting on <strong><%= marks.waiting_on %></strong>. The route counts it as waiting, not as your turn.</p>
+      <%= button_to "No longer waiting", burst_pull_request_waiting_path(burst, stop.number), method: :patch, params: {what: ""}, class: "quiet" %>
+    </div>
+  <% else %>
+    <details class="waiting">
+      <summary>Waiting on something outside this burst?</summary>
+      <%= form_with url: burst_pull_request_waiting_path(burst, stop.number), method: :patch do |form| %>
+        <%= form.label :what, "It waits for" %>
+        <%= form.text_field :what, placeholder: "e.g. production's encryption keys", required: true, autocomplete: "off" %>
+        <%= form.button "Set it aside", class: "quiet" %>
+        <p class="hint">The route then counts it as waiting, not as your turn, until you say it no longer is.</p>
+      <% end %>
+    </details>
+  <% end %>
+</section>

data/app/views/proctolog/pull_requests/_status.html.erb

@@ -0,0 +1,5 @@
+<%# locals: (burst:, stop:, standing:) %>
+<%# Where the pull request stands, in one line under its title: its place in the route, whose turn it is and what is open. What must be met, and the owner's mark, are in the Standing section after the description. %>
+<%= tag.section id: "standing", class: "status", aria: {label: "Where it stands"}, data: {turn: standing.turn} do %>
+  <p class="stands"><span class="position"><%= position_of(stop) %>.</span><% if stop.pull_request.unopened? %> <span class="unopened">Not opened, on <code><%= stop.pull_request.head %></code>.</span><% end %> <%= turn_tag(standing) %>. <span class="reasons"><%= reasons_of(standing).upcase_first %>.</span></p>
+<% end %>

data/app/views/proctolog/pull_requests/_try.html.erb

@@ -0,0 +1,122 @@
+<%# locals: (burst:, stop:, scenarios:) %>
+<%# Under the outline. First what a scenario needs before it tries this pull request, a bead to each as Standing has them: a checkout that can run the app, with this pull request's latest commit in it, and the server up on it. When the checkout falls short, one button opens the fix in a popup, as words to copy. Then a button for each scenario, named for it, that makes its state and opens a browser where its steps begin. try.js reads the panel again from the page whenever the server's state moves. %>
+<% server = burst.server %>
+<% state = server.state %>
+<% runnable = server.app.described? && server.runnable? %>
+<% ready = runnable && state == :up %>
+<% holds = server.holds?(stop.head_oid) %>
+<% app = burst.repository.split("/").last.humanize %>
+<% fresh = burst.fresh_sitting(stop) unless runnable && holds %>
+<%= tag.aside id: "try", class: "try", aria: {labelledby: "try-heading"}, data: {try: "", desk: "", state:, status_url: burst_sitting_server_path(burst)} do %>
+  <h2 id="try-heading">Try it</h2>
+
+  <ul class="conditions needs">
+    <% if !server.app.described? %>
+      <li data-met="false">
+        <span class="name">Nothing says how to run <%= app %></span>
+        <span class="detail">This checkout has no <code>.proctolog/app.yml</code>. The desk's <code>docs/manual/app.md</code> says how to write one.</span>
+      </li>
+    <% else %>
+      <li data-met="<%= runnable %>">
+        <span class="name"><%= runnable ? "The checkout can run #{app}" : "The checkout can't run #{app}" %></span>
+        <span class="detail"><%= folder(server.checkout) %><% unless runnable %> has no <code>.proctolog/app.yml</code><% end %>.</span>
+      </li>
+    <% end %>
+
+    <li data-met="<%= holds %>">
+      <span class="name"><%= holds ? "It has ##{stop.number}'s latest commit" : "It doesn't have ##{stop.number}'s latest commit" %></span>
+      <span class="detail">
+        <% if holds %>
+          On <code><%= server.serving %></code><%= ", with changes of its own" if server.changed? %>.
+        <% else %>
+          <%= short(stop.head_oid) %>, from <%= day_of(stop.committed_at) %>. The checkout is from <%= day_of(server.head_at) %>.
+        <% end %>
+      </span>
+    </li>
+
+    <% if fresh %>
+      <li class="remedy">
+        <button type="button" class="quiet" popovertarget="try-fix">How to fix it</button>
+      </li>
+    <% end %>
+
+    <%= tag.li class: "server-state", data: {met: state == :up, state:} do %>
+      <% case state %>
+      <% when :up %>
+        <span class="name">The server is up</span>
+        <div class="detail server-action">
+          <span>On <%= link_to ":#{server.port}", server.address, target: "_blank", rel: "noopener" %>.</span>
+          <% if server.started_here? %>
+            <%= button_to "stop", burst_sitting_server_path(burst), method: :delete, class: "quiet", form: {data: {server: ""}} %>
+          <% else %>
+            Started outside the desk, so it is stopped where it runs.
+          <% end %>
+        </div>
+      <% when :starting %>
+        <span class="name">The server is starting</span>
+        <div class="detail server-action">
+          <span>A minute or two, the first time longer.</span>
+          <%= button_to "stop", burst_sitting_server_path(burst), method: :delete, class: "quiet", form: {data: {server: ""}} %>
+        </div>
+      <% else %>
+        <span class="name"><%= server.crashed? ? "The server has stopped" : "The server is down" %></span>
+        <div class="detail server-action">
+          <% if runnable %>
+            <%= button_to (server.crashed? ? "start again" : "start"), burst_sitting_server_path(burst), class: "quiet", form: {data: {server: ""}} %>
+          <% else %>
+            It waits for the checkout.
+          <% end %>
+        </div>
+        <% if server.crashed? %>
+          <span class="detail"><span class="log" tabindex="0" aria-describedby="try-log">The end of its log</span></span>
+          <pre class="tail" id="try-log" role="tooltip"><%= log_tail(server) %></pre>
+        <% end %>
+      <% end %>
+    <% end %>
+  </ul>
+
+  <%# A button to each scenario with its name on it, so two never read as one; what they share, the browser, is said once above them. %>
+  <% shared = scenarios.map { it.browser.name }.uniq.one? %>
+  <section class="tries" aria-label="Scenarios">
+    <h3>Scenarios</h3>
+    <p class="lede"><%= tries_lede(scenarios.first, ready:, shared:) %></p>
+    <ol>
+      <% scenarios.each do |scenario| %>
+        <li>
+          <%= button_to scenario.name, open_burst_scenario_path(burst, scenario), class: "try-one", disabled: !ready,
+                form: {target: ("_blank" if scenario.browser.mine?), data: {set_up: ""}} %>
+          <span class="how"><%= how_it_starts(scenario, browser: !shared) %></span>
+        </li>
+      <% end %>
+    </ol>
+  </section>
+
+  <% if fresh %>
+    <%# The fix as the owner carries it out: what is wrong in plain words, then each step with its words to copy. %>
+    <div id="try-fix" popover class="try-pop" aria-labelledby="try-fix-heading">
+      <h3 id="try-fix-heading">A checkout that can run #<%= stop.number %></h3>
+      <p>
+        The scenarios run in <code><%= shown_path(server.checkout) %></code>. It is on <code><%= server.serving %></code>, made <%= day_of(server.head_at) %><%= server.head_subject&.then { safe_join([": “", it, "”"]) } %>.
+        <% unless holds %>It doesn't have #<%= stop.number %>'s latest commit, <%= short(stop.head_oid) %>.<% end %>
+        <% unless runnable %>Nor does it have <code>.proctolog/app.yml</code>, which came to <%= app %> with <%= arrival_of(server.app) %>. Without it the desk could run <%= app %> on its own development database, so it starts nothing there.<% end %>
+      </p>
+      <p>Make a checkout of #<%= stop.number %> that has both, and let the scenarios run in it.</p>
+      <ol class="steps">
+        <li>
+          <p>Make it<% unless fresh.picked? %>: #<%= stop.number %>'s head with <%= tag.code(fresh.arrival) %> picked onto it, left uncommitted<% end %>.</p>
+          <%= copyable fresh.make %>
+          <% if (files = fresh.conflicts).any? %>
+            <p>Git will stop on a conflict in <%= safe_join(files.map { tag.code(it) }, ", ") %>. Settle it in place; there is nothing to commit.</p>
+          <% end %>
+        </li>
+        <li>
+          <p>Make the scenarios run in it: in this burst file, put these lines in place of its <code>sitting:</code>.</p>
+          <%= copyable shown_path(burst.file) %>
+          <%= copyable fresh.setting %>
+        </li>
+        <li><p>Reload this page and press start.</p></li>
+      </ol>
+      <button type="button" class="quiet" popovertarget="try-fix" popovertargetaction="hide">Close</button>
+    </div>
+  <% end %>
+<% end %>