agentboard 0.2.0

data/app/views/agentboard/tickets/show.html.erb

@@ -0,0 +1,343 @@
+<% t = @ticket %>
+<% content_for :title, "#{t.key} #{t.title}" %>
+<% content_for :crumbs do %>
+  <%= link_to "Board", board_path %><span class="sep">/</span><span class="mono"><%= t.key %></span>
+<% end %>
+<% content_for :actions do %>
+  <% if can?("ticket.write") %><%= link_to edit_ticket_path(t), class: "btn btn-sm" do %><%= icon("edit", size: 13) %> Edit<% end %><% end %>
+<% end %>
+<% lease = t.active_lease %>
+<% next_states = Agentboard::StateMachines::Ticket.next_states(t.status) - ["claimed"] %>
+
+<div class="detail">
+  <div class="detail-main">
+    <div class="row" style="gap:10px">
+      <%= status_pill(t.status) %><%= priority_icon(t.priority) %><span class="muted"><%= t.priority_label %></span><%= kind_badge(t.kind) %>
+      <% t.labels.each do |l| %><span class="label-chip" style="--h:<%= Digest::MD5.hexdigest(l)[0, 2].to_i(16) * 360 / 255 %>"><%= l %></span><% end %>
+    </div>
+    <h1 class="ticket-title"><%= t.title %></h1>
+
+    <% if t.status == "blocked" %>
+      <div class="callout callout-bad mb"><%= icon("ban", size: 16) %><div><strong>Blocked.</strong> <%= t.blocked_reason %></div></div>
+    <% end %>
+
+    <div class="prose mb"><%= t.description %></div>
+
+    <% t.artifacts.select { |a| a.kind == "capture" }.first(1).each do |cap| %>
+      <% m = cap.metadata %>
+      <section class="card" id="capture">
+        <div class="card-head"><h2><%= icon("eye", size: 15) %> Captured from the app</h2>
+          <span class="muted" style="margin-left:auto;font-size:12px">by <%= m["captured_by"] %> · <%= ago(cap.created_at) %></span></div>
+        <div class="card-body stack-sm">
+          <dl class="kv">
+            <dt>Page</dt><dd class="mono" style="font-size:12px"><%= m["url"] || "—" %></dd>
+            <dt>Route</dt><dd><code><%= m["route"] || "—" %></code></dd>
+            <dt>Viewport</dt><dd class="muted"><%= m.dig("viewport", "width") %>×<%= m.dig("viewport", "height") %></dd>
+          </dl>
+          <% Array(m["elements"]).each_with_index do |el, i| %>
+            <div class="list-row" style="padding:8px 0;align-items:flex-start">
+              <span class="pill pill-review" style="height:20px"><%= i + 1 %></span>
+              <span class="grow" style="min-width:0">
+                <code style="word-break:break-all"><%= el["selector"] %></code>
+                <% if el["template"] %><div style="font-size:12px;color:var(--c-green)" class="mono">↳ <%= el["template"] %></div><% end %>
+                <% if el["text"].present? %><div class="muted" style="font-size:12.5px">“<%= el["text"].truncate(140) %>”</div><% end %>
+              </span>
+            </div>
+          <% end %>
+          <% if (shot = t.artifacts.find { |a| a.kind == "screenshot" }) %>
+            <img src="<%= screenshot_capture_path(shot) %>" alt="Screenshot of the captured area" style="max-width:100%;border-radius:10px;border:1px solid var(--border);margin-top:6px">
+          <% end %>
+          <% if Array(m["console_errors"]).any? %>
+            <details class="output"><summary><%= m["console_errors"].size %> console error(s)</summary><pre><%= m["console_errors"].join("\n") %></pre></details>
+          <% end %>
+          <p class="hint" style="margin:4px 0 0">Agents receive these templates first in their context.</p>
+        </div>
+      </section>
+    <% end %>
+
+    <div class="row row-wrap mb" style="gap:6px">
+      <% unless can?("ticket.transition") %><span class="hint">Read-only: your role (<%= current_actor.role %>) cannot change tickets.</span><% next_states = [] %><% end %>
+      <% if t.status == "ready" && can?("ticket.claim") %>
+        <%= button_to transition_ticket_path(t), params: { to: "claimed" }, class: "btn btn-sm", form: { style: "display:inline" } do %><%= icon("lock", size: 13) %> Claim<% end %>
+      <% end %>
+      <% next_states.each do |to| %>
+        <% if %w[blocked cancelled reopened].include?(to) || (to == "ready" && t.status == "backlog" && t.acceptance_criteria.none?) %>
+          <details class="popover">
+            <summary class="btn btn-sm <%= "btn-danger" if %w[blocked cancelled].include?(to) %>"><%= status_glyph(to) %> <%= Agentboard::StateMachines::Ticket::LABELS[to] %>…</summary>
+            <div class="popover-panel" style="left:0;right:auto;min-width:300px">
+              <%= form_with url: transition_ticket_path(t), method: :post, class: "stack-sm", style: "padding:6px" do %>
+                <%= hidden_field_tag :to, to %>
+                <% if to == "ready" %><%= hidden_field_tag :override_criteria, "1" %><span class="hint">No acceptance criteria yet. Override with a reason (recorded in the audit log).</span><% end %>
+                <input class="input" name="reason" placeholder="Reason (required)" required autofocus>
+                <button class="btn btn-primary btn-sm">Move to <%= Agentboard::StateMachines::Ticket::LABELS[to] %></button>
+              <% end %>
+            </div>
+          </details>
+        <% elsif to == "testing" && !t.artifacts.where(kind: %w[commit diff pull_request]).exists? %>
+          <%= button_to transition_ticket_path(t), params: { to: to, verification_requested: "1" }, class: "btn btn-sm", form: { style: "display:inline" } do %><%= status_glyph(to) %> Request verification<% end %>
+        <% elsif to == "done" && !can?("ticket.complete") %>
+          <span class="btn btn-sm is-disabled" title="Completing tickets needs the maintainer role"><%= icon("lock", size: 13) %> Mark done</span>
+        <% elsif to == "done" %>
+          <%= button_to complete_ticket_path(t), params: { lock_version: t.lock_version }, class: "btn btn-sm #{@completion[:ok] ? "btn-success" : "is-disabled"}", form: { style: "display:inline" }, title: @completion[:missing].join("\n") do %><%= icon("check", size: 13) %> Mark done<% end %>
+        <% else %>
+          <%= button_to transition_ticket_path(t), params: { to: to, lock_version: t.lock_version }, class: "btn btn-sm", form: { style: "display:inline" } do %><%= status_glyph(to) %> <%= Agentboard::StateMachines::Ticket::LABELS[to] %><% end %>
+        <% end %>
+      <% end %>
+    </div>
+
+    <section class="card" id="criteria">
+      <div class="card-head">
+        <h2><%= icon("check", size: 15) %> Acceptance criteria</h2>
+        <% done, total = t.criteria_progress %>
+        <span class="row muted" style="margin-left:auto"><%= meter(done, total) %> <%= done %>/<%= total %></span>
+      </div>
+      <div class="card-body">
+        <div class="criteria">
+          <% t.acceptance_criteria.each do |c| %>
+            <div class="criterion">
+              <span class="cbox is-<%= c.state %>"><% if c.state == "verified" %><%= icon("check", size: 12, stroke: 3) %><% elsif c.state == "failed" %><%= icon("x", size: 12, stroke: 3) %><% elsif c.state == "waived" %>–<% end %></span>
+              <div class="criterion-text">
+                <div><%= c.description %></div>
+                <div class="faint" style="font-size:11.5px"><%= c.verification_kind %><% if c.verified_by %> · <%= c.state %> by <%= c.verified_by %> <%= ago(c.verified_at) %><% end %></div>
+              </div>
+              <div class="criterion-actions" <%= "hidden" unless can?("ticket.write") %>>
+                <% { "verified" => "check", "failed" => "x", "waived" => "ban", "pending" => "refresh" }.except(c.state).each do |state, ic| %>
+                  <%= button_to ticket_criterion_path(t, c), method: :patch, params: { state: state }, class: "btn btn-ghost btn-sm btn-icon", title: "Mark #{state}", form: { style: "display:inline" } do %><%= icon(ic, size: 13) %><% end %>
+                <% end %>
+              </div>
+            </div>
+          <% end %>
+        </div>
+        <%= form_with url: ticket_criteria_path(t), scope: :criterion, class: "row mt-sm", hidden: !can?("ticket.write") do |f| %>
+          <%= f.text_field :description, class: "input", placeholder: "Add a criterion…", required: true %>
+          <%= f.select :verification_kind, Agentboard::AcceptanceCriterion::VERIFICATION_KINDS, {}, class: "select", style: "width:120px" %>
+          <button class="btn"><%= icon("plus", size: 14) %></button>
+        <% end %>
+      </div>
+    </section>
+
+    <% if t.subtasks.any? || t.parent %>
+      <section class="card">
+        <div class="card-head"><h2><%= icon("layers", size: 15) %> <%= t.parent ? "Part of" : "Subtasks" %></h2>
+          <% unless t.parent %><%= link_to new_ticket_path(parent: t.id), class: "btn btn-ghost btn-sm", style: "margin-left:auto" do %><%= icon("plus", size: 12) %> Subtask<% end %><% end %></div>
+        <div class="card-body-flush">
+          <% (t.parent ? [t.parent] : t.subtasks.includes(:project).ordered).each do |sub| %>
+            <%= link_to ticket_path(sub), class: "list-row" do %><%= status_glyph(sub.status) %><span class="mono muted" style="font-size:12px"><%= sub.key %></span><span class="grow truncate"><%= sub.title %></span><%= status_pill(sub.status) %><% end %>
+          <% end %>
+        </div>
+      </section>
+    <% end %>
+
+    <section class="card">
+      <div class="card-head"><h2><%= icon("sparkles", size: 15) %> Suggestions</h2><span class="muted" style="margin-left:auto;font-size:12px">From static analysis · nothing changes until you accept</span></div>
+      <div class="card-body-flush">
+        <turbo-frame id="ticket-suggestions" src="<%= suggestions_ticket_path(t) %>" loading="lazy">
+          <div class="empty" style="padding:16px"><span>Analysing the repository…</span></div>
+        </turbo-frame>
+      </div>
+    </section>
+
+    <section class="card">
+      <div class="card-head">
+        <h2><%= icon("flask", size: 15) %> Verification</h2>
+        <span class="muted" style="margin-left:auto;font-size:12px">head <%= sha_tag(@head_sha) %></span>
+        <%= button_to verify_ticket_path(t), class: "btn btn-sm", form: { style: "display:inline", hidden: !can?("execution.start") }, title: "Run the approved command catalog against the repository HEAD" do %><%= icon("play", size: 12) %> Verify HEAD<% end %>
+      </div>
+      <div class="card-body-flush">
+        <% if @checks[:checks].empty? %>
+          <div class="empty" style="padding:20px"><span><%= @checks[:missing].first || "No required checks configured" %></span></div>
+        <% else %>
+          <% @checks[:checks].each do |c| %>
+            <div class="check-row">
+              <%= execution_pill(c[:status]) %>
+              <strong class="mono" style="font-size:12.5px"><%= c[:name] %></strong>
+              <span class="muted grow" style="font-size:12px"><%= c[:status] == "stale" ? "passed only on an older commit — re-run for the current head" : (c[:status] == "missing" ? "not run for this head" : "") %></span>
+              <%= sha_tag(c[:commit_sha]) %>
+            </div>
+          <% end %>
+        <% end %>
+      </div>
+    </section>
+
+    <section class="card">
+      <div class="card-head"><h2><%= icon("commit", size: 15) %> Evidence</h2><span class="muted" style="margin-left:auto;font-size:12px"><%= @artifacts.size %> artifacts</span></div>
+      <div class="card-body-flush">
+        <% if @artifacts.empty? %>
+          <div class="empty" style="padding:20px"><span>Commits, diffs, test reports and PRs linked by agents or the runtime appear here.</span></div>
+        <% end %>
+        <% @artifacts.each do |a| %>
+          <div class="list-row">
+            <%= icon({ "commit" => "commit", "pull_request" => "branch", "test_report" => "flask", "context" => "layers", "log" => "terminal" }.fetch(a.kind, "file"), size: 15, klass: "muted") %>
+            <span class="grow truncate">
+              <strong style="font-weight:550"><%= a.title.presence || a.kind.humanize %></strong>
+              <% if a.commit_sha %> <%= sha_tag(a.commit_sha) %><% end %>
+              <% if a.kind == "commit" && a.metadata["verified_in_repo"] == false %><span class="pill pill-blocked" style="height:18px;font-size:11px">not in repo</span><% end %>
+            </span>
+            <%= provenance_badge(a.provenance) %>
+            <span class="faint" style="font-size:12px"><%= ago(a.created_at) %></span>
+          </div>
+        <% end %>
+        <details class="popover" style="padding:8px 14px">
+          <summary class="btn btn-ghost btn-sm"><%= icon("branch", size: 13) %> Link pull request manually</summary>
+          <%= form_with url: link_pr_ticket_path(t), class: "stack-sm mt-sm" do %>
+            <input class="input" name="url" placeholder="https://github.com/owner/repo/pull/123" required>
+            <div class="row">
+              <select name="state" class="select" style="width:130px"><option>open</option><option>merged</option><option>closed</option></select>
+              <input class="input mono" name="merge_commit_sha" placeholder="merge commit SHA (required for merged)">
+              <button class="btn btn-sm">Link</button>
+            </div>
+            <span class="hint">A manual merge is accepted only if the merge commit exists locally and contains the reviewed head. Prefer the signed GitHub webhook.</span>
+          <% end %>
+        </details>
+      </div>
+    </section>
+
+    <section class="card">
+      <div class="card-head"><h2><%= icon("terminal", size: 15) %> Executions</h2></div>
+      <div class="card-body-flush">
+        <% if @executions.empty? %>
+          <div class="empty" style="padding:20px"><span>No executions yet. Start one from the panel on the right, or let a developer's own agent session work on it through MCP.</span></div>
+        <% end %>
+        <% @executions.each do |e| %>
+          <%= link_to execution_path(e), class: "list-row" do %>
+            <%= provider_avatar(e.provider_key) %>
+            <span class="grow"><strong style="font-weight:550"><%= e.action.humanize %></strong> <span class="muted">· attempt <%= e.attempt %> · <%= e.provider_key %></span></span>
+            <% if e.verification_results.any? %><span class="muted" style="font-size:12px"><%= e.verification_results.count(&:passed?) %>/<%= e.verification_results.size %> checks</span><% end %>
+            <%= execution_pill(e.status) %>
+            <span class="faint" style="font-size:12px;width:90px;text-align:right"><%= ago(e.created_at) %></span>
+          <% end %>
+        <% end %>
+      </div>
+    </section>
+
+    <section class="card" id="activity">
+      <div class="card-head"><h2><%= icon("pulse", size: 15) %> Activity</h2>
+        <span class="row" style="margin-left:auto;gap:4px"><% %w[confirmed provider_reported git_observed inferred].each do |p| %><%= provenance_badge(p) %><% end %></span>
+      </div>
+      <div class="card-body">
+        <%= form_with url: ticket_comments_path(t), scope: :comment, class: "composer mb", hidden: !can?("ticket.comment") do |f| %>
+          <%= f.text_area :body, class: "textarea", placeholder: "Leave a comment… (secrets are redacted automatically)", required: true %>
+          <div class="row"><span class="hint grow">Comments are visible to agents through MCP.</span><button class="btn btn-primary btn-sm">Comment</button></div>
+        <% end %>
+        <div class="timeline">
+          <% comments = t.comments.index_by(&:id) %>
+          <% @events.each do |e| %>
+            <% ic, tone = event_icon(e) %>
+            <div class="tl-item">
+              <span class="tl-icon <%= tone %>"><%= icon(ic, size: 13) %></span>
+              <div class="tl-body">
+                <div class="tl-line">
+                  <span class="tl-who"><%= actor_label(e) %></span>
+                  <span><%= event_title(e) %></span>
+                  <% unless e.provenance == "confirmed" %><%= provenance_badge(e.provenance) %><% end %>
+                  <span class="tl-when"><%= ago(e.occurred_at) %></span>
+                </div>
+                <% if e.event_type == "ticket.commented" && (c = comments[e.payload["comment_id"]]) %>
+                  <div class="comment-bubble"><%= c.body %></div>
+                <% end %>
+              </div>
+            </div>
+          <% end %>
+        </div>
+      </div>
+    </section>
+  </div>
+
+  <aside class="detail-side">
+    <div class="card"><div class="card-body">
+      <dl class="kv">
+        <dt>Status</dt><dd><%= status_pill(t.status) %></dd>
+        <dt>Priority</dt><dd><%= priority_icon(t.priority) %> <%= t.priority_label %></dd>
+        <dt>Lease</dt><dd><% if lease %><%= avatar(lease.holder_label, kind: lease.agent_session_id ? "agent" : "human", size: 20) %><span class="truncate"><%= lease.holder_label %></span><span class="faint" style="font-size:11.5px">until <%= lease.expires_at.strftime("%H:%M") %> · #<%= lease.fencing_token %></span><% else %><span class="faint">Unclaimed</span><% end %></dd>
+        <dt>Depends on</dt>
+        <dd>
+          <% t.dependencies.includes(:depends_on_ticket).each do |d| %>
+            <span class="row" style="gap:4px"><%= status_glyph(d.depends_on_ticket.status) %><%= link_to d.depends_on_ticket.key, ticket_path(d.depends_on_ticket), class: "link mono", style: "font-size:12px" %>
+              <%= button_to ticket_dependency_path(t, d), method: :delete, class: "btn btn-ghost btn-sm btn-icon", form: { style: "display:inline" }, title: "Remove" do %><%= icon("x", size: 11) %><% end %></span>
+          <% end %>
+          <details class="popover"><summary class="btn btn-ghost btn-sm"><%= icon("plus", size: 12) %> Add</summary>
+            <div class="popover-panel" style="left:0;right:auto">
+              <%= form_with url: ticket_dependencies_path(t), class: "row", style: "padding:6px" do %>
+                <select name="depends_on" class="select"><% @other_tickets.each do |o| %><option value="<%= o.key %>"><%= o.key %> — <%= o.title.truncate(40) %></option><% end %></select>
+                <button class="btn btn-sm btn-primary">Add</button>
+              <% end %>
+            </div>
+          </details>
+        </dd>
+        <dt>Milestone</dt><dd><% if t.milestone %><%= icon("flag", size: 13, klass: "muted") %> <%= t.milestone.name %><% else %><span class="faint">None</span><% end %></dd>
+        <% if t.subtasks.none? && t.parent.nil? %><dt>Subtasks</dt><dd><%= link_to new_ticket_path(parent: t.id), class: "btn btn-ghost btn-sm" do %><%= icon("plus", size: 12) %> Add<% end %></dd><% end %>
+        <dt>Created</dt><dd class="muted"><%= ago(t.created_at) %></dd>
+        <dt>Version</dt><dd class="muted mono" style="font-size:12px">v<%= t.lock_version %></dd>
+      </dl>
+    </div></div>
+
+    <div class="card">
+      <div class="card-head"><h3><%= icon("shield", size: 14) %> Completion gates</h3></div>
+      <div class="card-body">
+        <% gates = [] %>
+        <% gates << ["Acceptance criteria verified", t.acceptance_criteria.any? && t.acceptance_criteria.all?(&:satisfied?)] if Agentboard.config.completion["require_criteria_verified"] %>
+        <% gates << ["Required checks pass at head", @checks[:ok]] if Agentboard.config.completion["require_checks"] %>
+        <% gates << ["Human review approved for head", @completion.dig(:review, :status) == "approved"] if Agentboard.config.completion["require_approval"] %>
+        <% gates << ["Merged PR verified", @completion.dig(:pull_request, :state) == "merged"] if Agentboard::CompletionPolicy.merged_pr_required?(t) %>
+        <% gates.each do |label, ok| %>
+          <div class="gate <%= ok ? "ok" : "no" %>"><%= icon(ok ? "check" : "x", size: 14, stroke: 2.5) %><span><%= label %></span></div>
+        <% end %>
+        <div class="divider"></div>
+        <p class="hint" style="margin:0">An agent can request completion but cannot bypass these gates. Evidence is checked against persisted records only.</p>
+      </div>
+    </div>
+
+    <% pending = @approvals.select(&:pending?) %>
+    <% if pending.any? %>
+      <div class="card">
+        <div class="card-head"><h3><%= icon("shield", size: 14) %> Awaiting your approval</h3></div>
+        <div class="card-body stack">
+          <% pending.each do |a| %>
+            <%= render "agentboard/approvals/approval", approval: a %>
+          <% end %>
+        </div>
+      </div>
+    <% end %>
+
+    <div class="card" <%= "hidden" unless can?("execution.start") %>>
+      <div class="card-head"><h3><%= icon("play", size: 14) %> Run an agent</h3></div>
+      <div class="card-body">
+        <%= form_with url: run_ticket_path(t), class: "stack-sm" do %>
+          <%= hidden_field_tag :idempotency_key, SecureRandom.uuid %>
+          <div class="form-grid" style="grid-template-columns:1fr 1fr">
+            <div class="field"><label>Provider</label>
+              <select name="provider" class="select"><% @providers.each do |p| %><option value="<%= p %>" <%= "selected" if p == "fake" %>><%= Agentboard::Providers.registry.adapter_class(p).display_name %></option><% end %></select></div>
+            <div class="field"><label>Action</label>
+              <select name="action_name" class="select"><% %w[implement plan review fix_tests summarize].each do |a| %><option value="<%= a %>"><%= a.humanize %></option><% end %></select></div>
+          </div>
+          <button class="btn btn-primary" <%= "disabled" unless Agentboard::Executions::RUNNABLE_TICKET_STATES.include?(t.status) %>><%= icon("play", size: 13) %> Start execution</button>
+          <span class="hint">Runs in an isolated worktree; results are verified independently.</span>
+        <% end %>
+        <% if @workflows.any? %>
+          <div class="divider"></div>
+          <%= form_with url: run_ticket_path(t), class: "row" do %>
+            <select name="workflow" class="select"><% @workflows.each do |w| %><option value="<%= w.name %>"><%= w.name %> v<%= w.version %></option><% end %></select>
+            <button class="btn"><%= icon("workflow", size: 13) %> Run</button>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+
+    <% if @sessions.any? %>
+      <div class="card">
+        <div class="card-head"><h3><%= icon("bot", size: 14) %> Agent sessions</h3></div>
+        <div class="card-body-flush">
+          <% @sessions.each do |link| %>
+            <div class="list-row">
+              <%= provider_avatar(link.agent_session.provider_key, size: 20) %>
+              <span class="grow truncate"><%= link.agent_session.display_name %><br><span class="faint" style="font-size:11.5px"><%= link.source.humanize %> · <%= link.agent_session.trust_level %><%= " · ended" if link.ended_at %></span></span>
+              <% if link.confidence == "needs_confirmation" && link.ended_at.nil? %>
+                <%= button_to "Confirm", session_path(link.agent_session), method: :patch, params: { ticket_key: t.key }, class: "btn btn-sm" %>
+              <% end %>
+            </div>
+          <% end %>
+        </div>
+      </div>
+    <% end %>
+  </aside>
+</div>

data/app/views/agentboard/tickets/suggestions.html.erb

@@ -0,0 +1,21 @@
+<turbo-frame id="ticket-suggestions">
+  <% if @suggestions.empty? %>
+    <div class="empty" style="padding:16px"><span>No suggestions for this ticket.</span></div>
+  <% else %>
+    <% labels = { "file" => "Relevant file", "complexity" => "Estimated size", "criterion" => "Criterion", "subtask" => "Subtask", "dependency" => "Possible dependency" } %>
+    <% @suggestions.group_by(&:kind).each do |kind, items| %>
+      <div class="section-title" style="margin:12px 16px 4px"><%= labels[kind] || kind %></div>
+      <% items.each do |s| %>
+        <div class="list-row" style="padding:7px 16px">
+          <span class="grow" style="min-width:0">
+            <span class="<%= "mono" if kind == "file" %>" style="font-size:<%= kind == "file" ? "12px" : "13px" %>"><%= s.text %></span>
+            <span class="faint" style="font-size:11.5px;display:block"><%= s.reason %></span>
+          </span>
+          <% unless kind == "file" %>
+            <%= button_to accept_suggestion_ticket_path(@ticket), params: { kind: kind, value: s.value }, class: "btn btn-sm", form: { style: "display:inline", data: { turbo_frame: "_top" } } do %><%= icon("plus", size: 12) %> Accept<% end %>
+          <% end %>
+        </div>
+      <% end %>
+    <% end %>
+  <% end %>
+</turbo-frame>

data/app/views/agentboard/workflow_runs/show.html.erb

@@ -0,0 +1,28 @@
+<% content_for :title, "Workflow run" %>
+<% content_for :crumbs do %><%= link_to "Workflows", workflows_path %><span class="sep">/</span><%= link_to @run.ticket.key, ticket_path(@run.ticket) %><span class="sep">/</span><span><%= @run.workflow_definition.name %></span><% end %>
+<% content_for :actions do %>
+  <% unless @run.terminal? %><%= button_to cancel_workflow_run_path(@run), class: "btn btn-sm btn-danger", form: { style: "display:inline" } do %><%= icon("stop", size: 12) %> Cancel run<% end %><% end %>
+<% end %>
+<div class="row mb"><h1><%= @run.workflow_definition.name %></h1><%= execution_pill(@run.status) %><span class="muted">v<%= @run.workflow_definition.version %> · started <%= ago(@run.started_at) %></span></div>
+<% if @run.status == "waiting_for_approval" %>
+  <div class="callout callout-warn mb"><%= icon("shield", size: 16) %><div>Waiting for a human approval. <%= link_to "Review approvals →", approvals_path, class: "link" %></div></div>
+<% end %>
+<div class="card mb"><div class="card-body"><%= render "agentboard/shared/dag", definition: @definition, steps: @steps %></div></div>
+<div class="card card-body-flush">
+  <table class="table table-compact">
+    <thead><tr><th>Step</th><th>Attempt</th><th>Status</th><th>Head</th><th>Execution</th><th>Error</th><th class="right">Finished</th></tr></thead>
+    <tbody>
+      <% @all_steps.each do |s| %>
+        <tr>
+          <td class="mono"><%= s.step_key %> <span class="faint"><%= s.step_type %></span></td>
+          <td><%= s.attempt %></td>
+          <td><%= execution_pill(s.status) %></td>
+          <td><%= sha_tag(s.output["head_sha"]) %></td>
+          <td><% if (ex = s.executions.max_by(&:created_at)) %><%= link_to "exec-#{ex.attempt}", execution_path(ex), class: "link" %><% else %><span class="faint">—</span><% end %></td>
+          <td class="muted" style="font-size:12px"><%= s.error.to_s.truncate(80) %><% if s.available_at && s.status == "pending" %>retry <%= ago(s.available_at).to_s.sub(" ago", "").html_safe %><% end %></td>
+          <td class="right muted"><%= ago(s.finished_at) if s.finished_at %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>

data/app/views/agentboard/workflows/index.html.erb

@@ -0,0 +1,49 @@
+<% content_for :title, "Workflows" %>
+<% content_for :crumbs do %><%= icon("workflow", size: 16, klass: "muted") %> <span>Workflows</span><% end %>
+<% content_for :actions do %>
+  <%= link_to workflows_path(sync: 1), class: "btn btn-sm" do %><%= icon("refresh", size: 13) %> Sync .agentboard/workflows<% end %>
+<% end %>
+<div class="detail" style="grid-template-columns:minmax(0,1fr) minmax(0,1fr)">
+  <div class="stack">
+    <div class="card">
+      <div class="card-head"><h2><%= icon("layers", size: 15) %> Definitions</h2></div>
+      <div class="card-body-flush">
+        <% if @definitions.empty? %><div class="empty"><%= icon("workflow", size: 26) %><strong>No workflows yet</strong><span>Register one with the editor, or add YAML files to <code>.agentboard/workflows/</code>.</span></div><% end %>
+        <% @definitions.each do |name, versions| %>
+          <% latest = versions.first %>
+          <%= link_to workflow_path(latest), class: "list-row" do %>
+            <%= icon("workflow", size: 15, klass: "muted") %>
+            <span class="grow"><strong class="mono" style="font-size:13px"><%= name %></strong> <span class="muted">v<%= latest.version %> · <%= latest.definition["steps"].size %> steps</span></span>
+            <code title="<%= latest.digest %>"><%= latest.digest[0, 8] %></code>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+    <div class="card">
+      <div class="card-head"><h2><%= icon("play", size: 15) %> Recent runs</h2></div>
+      <div class="card-body-flush">
+        <% if @runs.empty? %><div class="empty" style="padding:20px">No runs yet.</div><% end %>
+        <% @runs.each do |r| %>
+          <%= link_to workflow_run_path(r), class: "list-row" do %>
+            <span class="mono" style="font-size:12px"><%= r.ticket.key %></span>
+            <span class="grow truncate"><%= r.workflow_definition.name %> <span class="muted">v<%= r.workflow_definition.version %></span></span>
+            <span class="muted" style="font-size:12px"><%= r.steps.count { |s| s.status == "succeeded" } %>/<%= r.workflow_definition.definition["steps"].size %></span>
+            <%= execution_pill(r.status) %>
+            <span class="faint" style="font-size:12px"><%= ago(r.created_at) %></span>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+  </div>
+  <div class="card" data-controller="workflow-validator" data-workflow-validator-url-value="<%= validate_workflows_path %>">
+    <div class="card-head"><h2><%= icon("edit", size: 15) %> Editor</h2><span class="muted" style="margin-left:auto;font-size:12px">YAML · safe-loaded · validated as a DAG</span></div>
+    <%= form_with url: workflows_path, class: "card-body stack" do %>
+      <textarea name="yaml" class="textarea code" spellcheck="false" data-workflow-validator-target="input" data-action="input->workflow-validator#schedule keydown->workflow-validator#indent"><%= @yaml %></textarea>
+      <pre class="validator" data-workflow-validator-target="output">Validating…</pre>
+      <div class="row">
+        <span class="hint grow">Commands reference the approved catalog by name — never shell strings.</span>
+        <button class="btn btn-primary" <%= "disabled" unless can?("workflow.manage") %>><%= icon("check", size: 14) %> Register version</button>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/agentboard/workflows/show.html.erb

@@ -0,0 +1,15 @@
+<% content_for :title, @definition.name %>
+<% content_for :crumbs do %><%= link_to "Workflows", workflows_path %><span class="sep">/</span><span class="mono"><%= @definition.name %></span><span class="faint">v<%= @definition.version %></span><% end %>
+<div class="card mb">
+  <div class="card-head"><h2><%= icon("workflow", size: 15) %> <%= @definition.name %></h2><span class="muted">v<%= @definition.version %> · digest <code><%= @definition.digest[0, 12] %></code> · immutable once used</span></div>
+  <div class="card-body"><%= render "agentboard/shared/dag", definition: @parsed, steps: nil %></div>
+</div>
+<div class="detail" style="grid-template-columns:minmax(0,1fr) 340px">
+  <div class="card"><div class="card-head"><h3>Source</h3></div><div class="card-body"><pre class="code-block"><%= @definition.source_yaml.presence || JSON.pretty_generate(@definition.definition) %></pre></div></div>
+  <div class="card"><div class="card-head"><h3><%= icon("play", size: 14) %> Start a run</h3></div>
+    <%= form_with url: start_workflow_path(@definition), class: "card-body stack-sm" do %>
+      <select name="ticket_key" class="select"><% current_project.tickets.open.ordered.limit(200).each do |t| %><option value="<%= t.key %>"><%= t.key %> — <%= t.title.truncate(42) %></option><% end %></select>
+      <button class="btn btn-primary"><%= icon("play", size: 13) %> Start workflow</button>
+    <% end %>
+  </div>
+</div>

data/app/views/layouts/agentboard/application.html.erb

@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title><%= [content_for(:title), "AgentBoard"].compact.join(" · ") %></title>
+  <%= csrf_meta_tags %>
+  <meta name="turbo-refresh-method" content="morph">
+  <meta name="turbo-refresh-scroll" content="preserve">
+  <meta name="color-scheme" content="light dark">
+  <script>(function(){var t=localStorage.getItem("agentboard-theme");if(t)document.documentElement.dataset.theme=t})()</script>
+  <link rel="stylesheet" href="<%= asset_url("agentboard.css") %>">
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect width='32' height='32' rx='8' fill='%235e5ce6'/><path d='M9 22V10h4v12zm5 0V14h4v8zm5 0v-6h4v6z' fill='white'/></svg>">
+  <script type="importmap">
+    <%= raw({ imports: {
+      "@hotwired/turbo" => asset_url("turbo.js"),
+      "@hotwired/stimulus" => asset_url("stimulus.js"),
+      "agentboard" => asset_url("agentboard.js")
+    } }.to_json) %>
+  </script>
+  <script type="module">import "agentboard"</script>
+</head>
+<body class="ab" data-controller="hotkeys theme">
+  <div class="shell" data-controller="pulse" data-pulse-url-value="<%= pulse_path %>">
+    <aside class="sidebar">
+      <div class="brand">
+        <span class="brand-mark"><%= icon("kanban", size: 15, stroke: 2.4) %></span>
+        <div>
+          <div class="brand-name">AgentBoard</div>
+          <div class="brand-project"><span class="project-key"><%= current_project.key %></span><span class="truncate"><%= current_project.name %></span></div>
+        </div>
+      </div>
+      <%= link_to new_ticket_path, class: "btn btn-sm", style: "margin: 0 4px 6px; justify-content:flex-start", data: { hotkey: "new-ticket" } do %>
+        <%= icon("plus", size: 14) %> New ticket <kbd style="margin-left:auto">C</kbd>
+      <% end %>
+      <div class="nav-section">Work</div>
+      <%= nav_link "Board", board_path, "kanban", active: controller_name == "board", kbd: "G B" %>
+      <%= nav_link "Backlog", tickets_path, "list", active: controller_name == "tickets" && action_name == "index", kbd: "G L" %>
+      <%= nav_link "Milestones", milestones_path, "flag", active: controller_name == "milestones" %>
+      <%= nav_link "Approvals", approvals_path, "shield", active: controller_name == "approvals", count: pending_approvals_count %>
+      <div class="nav-section">Agents</div>
+      <%= nav_link "Executions", executions_path, "terminal", active: controller_name == "executions", kbd: "G E" %>
+      <%= nav_link "Workflows", workflows_path, "workflow", active: %w[workflows workflow_runs].include?(controller_name), kbd: "G W" %>
+      <%= nav_link "Agents", agents_path, "bot", active: controller_name == "agents", kbd: "G A" %>
+      <div class="nav-section">Insight</div>
+      <%= nav_link "Analytics", analytics_path, "chart", active: controller_name == "analytics" %>
+      <%= nav_link "Settings", settings_path, "settings", active: controller_name == "settings" %>
+      <span hidden>
+        <a href="<%= board_path %>" data-hotkey-target="board"></a><a href="<%= tickets_path %>" data-hotkey-target="backlog"></a>
+        <a href="<%= executions_path %>" data-hotkey-target="executions"></a><a href="<%= agents_path %>" data-hotkey-target="agents"></a>
+        <a href="<%= workflows_path %>" data-hotkey-target="workflows"></a><a href="<%= approvals_path %>" data-hotkey-target="approvals"></a>
+      </span>
+      <div class="sidebar-footer">
+        <% daemon = (@daemon ||= Agentboard::Runtime::DaemonControl.status) %>
+        <%= link_to executions_path, class: "runtime-chip #{daemon[:running] ? "is-on" : ""}", title: daemon[:running] ? "Runtime daemon pid #{daemon[:pid]}" : "Start with: bundle exec agentboard daemon start" do %>
+          <span class="led"></span>
+          <span class="grow"><%= daemon[:running] ? "Runtime online" : "Runtime offline" %></span>
+          <span class="muted"><span id="runtime-active"><%= daemon.dig(:health, "active") || 0 %></span> active</span>
+        <% end %>
+        <div class="row" title="<%= current_actor.role %>">
+          <%= avatar(current_actor.label, size: 22) %>
+          <span class="truncate" style="font-size:12.5px;font-weight:550"><%= current_actor.label %></span>
+          <span class="faint" style="font-size:11px;margin-left:auto"><%= current_actor.role %></span>
+        </div>
+        <div class="row" style="justify-content:space-between">
+          <span class="faint" style="font-size:11.5px">v<%= Agentboard::VERSION %> · <%= Agentboard::Extensions.extensions.key?("agentboard-pro") && Agentboard::Extensions.extensions.values.any? { |e| e.enabled_features.any? } ? "Pro" : "Community" %></span>
+          <button class="btn btn-ghost btn-sm btn-icon" data-action="theme#toggle" title="Toggle theme"><%= icon("moon", size: 14) %></button>
+        </div>
+      </div>
+    </aside>
+    <main class="main">
+      <header class="topbar">
+        <nav class="crumbs"><%= yield :crumbs %></nav>
+        <div class="topbar-actions"><%= yield :actions %></div>
+      </header>
+      <% edition_notices.each do |notice| %>
+        <div class="callout callout-warn" style="margin:12px 22px 0"><%= icon("alert", size: 16) %><div><%= notice %></div></div>
+      <% end %>
+      <%= yield :toolbar %>
+      <%= content_for?(:bare) ? yield : tag.div(yield, class: "content") %>
+    </main>
+  </div>
+  <div class="toasts">
+    <% flash.each do |kind, message| %>
+      <div class="toast toast-<%= kind == "alert" ? "alert" : "notice" %>" data-controller="toast">
+        <%= icon(kind == "alert" ? "alert" : "check", size: 16) %>
+        <div class="grow"><%= message %></div>
+        <button class="btn btn-ghost btn-sm btn-icon" data-action="toast#dismiss" aria-label="Dismiss"><%= icon("x", size: 13) %></button>
+      </div>
+    <% end %>
+  </div>
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,49 @@
+Agentboard::Engine.routes.draw do
+  root to: "board#show"
+
+  get "board", to: "board#show", as: :board
+  get "pulse", to: "pulse#show", as: :pulse
+  get "assets/:name", to: "assets#show", as: :engine_asset, constraints: { name: /[a-z]+\.(css|js)/ }
+
+  resources :tickets, param: :key, constraints: { key: /[A-Z][A-Z0-9_-]*-\d+/ } do
+    member do
+      post :transition
+      post :move
+      post :verify
+      post :run
+      post :complete
+      post :link_pr
+      get :suggestions
+      post :accept_suggestion
+    end
+    resources :comments, only: :create
+    resources :criteria, only: %i[create update], controller: "criteria"
+    resources :dependencies, only: %i[create destroy]
+  end
+
+  resources :executions, only: %i[index show] do
+    member do
+      post :cancel
+      post :retry
+      post :resume
+      get :log
+    end
+  end
+
+  resources :milestones, only: %i[index create update]
+  resources :captures, only: :create do
+    member { get :screenshot }
+  end
+  resources :approvals, only: %i[index update]
+  resources :workflows, only: %i[index show create] do
+    collection { post :validate }
+    member { post :start }
+  end
+  resources :workflow_runs, only: :show do
+    member { post :cancel }
+  end
+  resources :sessions, only: :update
+  get "agents", to: "agents#index", as: :agents
+  get "analytics", to: "analytics#show", as: :analytics
+  get "settings", to: "settings#show", as: :settings
+end