cardinal-ai 0.2.4 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9765ce8a3b88ca8a2d72dcdaa766d67d42b0b1f1304ce44551fb0b31a8b62f84
-  data.tar.gz: 6bbd3904403e6e91b83a684d134c15ad402a98ab27f4600d6424752033565b0b
+  metadata.gz: ea33d976c3ebc53402438e5dae5e6b480842034e1a77a1c58142d62ad1f347e2
+  data.tar.gz: 7571417a375ab611c9345a6b2d7ab6cea33233e668d90414edae44ea2d116048
 SHA512:
-  metadata.gz: b91c51d2d12d2df7d7d1f81b7d8547545ed68cac112f4d844dd4666626ccb34081397dc038fa4620a8b0e76e804b18c64608d96c92be657238958bf4bf3540ff
-  data.tar.gz: 1e71c84583f3c6f02b3315ce7fa4abce078117dcb47ceb13a15a1641c3a90651673db22015c63ab8c1ca2e0683c136b50ac278b695e7144d34d7f7d2bf8378fc
+  metadata.gz: db9ec21facb032331fd8686f772e1c1313e0e84388f675eb723e92847c0c7638325d2af5ff8d392f2536c292d0929a79f64e53f040ef1206bb74097477c1f9e1
+  data.tar.gz: c290a471053fc66929db5fe9b3219bb49dc85f2b953b4a33beab0878e261d7ed4e815dc5b1b57ca9f8346f2ba9a7e73f7607a30f1af08e09a6665311dfdd6811

data/app/assets/stylesheets/cardinal.css

@@ -52,6 +52,7 @@ a { color: var(--blue); text-decoration: none; }
 }
 .topbar h1 { font-size: 16px; margin: 0; font-weight: 600; }
 .topbar h1 .sep { color: var(--accent); margin: 0 4px; }
+.topbar-left { display: flex; align-items: center; gap: 12px; }
 .topbar-right { display: flex; align-items: center; gap: 14px; }
 
 .theme-toggle {
@@ -60,6 +61,29 @@ a { color: var(--blue); text-decoration: none; }
 }
 .theme-toggle:hover { color: var(--text); border-color: var(--text-dim); }
 
+/* Repo deep dive button (card #12). Inline color/border come from the board's
+   staleness gradient (grey → red over 10 commits); .stale-critical flashes to
+   nag a refresh once the brief is too far behind HEAD to trust. */
+.topbar-right form.button_to { display: inline-flex; margin: 0; }
+.deep-dive {
+  display: inline-flex; align-items: center; gap: 6px;
+  background: transparent; border: 1px solid var(--border); border-radius: 6px;
+  color: var(--text-dim); font-weight: 600; padding: 5px 10px; line-height: 1;
+  cursor: pointer; white-space: nowrap;
+}
+.deep-dive:hover:not(:disabled) { filter: brightness(1.25); }
+.deep-dive:disabled { cursor: default; opacity: .8; }
+.deep-dive.stale-critical { animation: stale-flash 1.1s ease-in-out infinite; }
+@keyframes stale-flash {
+  0%, 100% { opacity: 1; box-shadow: 0 0 0 0 rgba(212, 51, 51, .55); }
+  50%      { opacity: .7; box-shadow: 0 0 0 3px rgba(212, 51, 51, 0); }
+}
+
+.pull-form { display: inline; }
+#repo-pull-status { font-size: 0.85rem; }
+#repo-pull-status .pull-ok  { color: var(--green); }
+#repo-pull-status .pull-err { color: var(--red); }
+
 .attention summary {
   cursor: pointer;
   color: var(--amber);
@@ -154,6 +178,10 @@ button, input[type="submit"] {
 body.dragging .drop-hint { display: block; }
 .ticker { font-size: 11px; color: var(--text-dim); margin: 0 4px 8px; }
 
+.column-footer { margin-top: 8px; padding-top: 8px; border-top: 1px solid var(--border); font-size: 11px; color: var(--text-dim); }
+.footer-row { display: flex; justify-content: space-between; gap: 8px; padding: 1px 4px; }
+.footer-value { font-variant-numeric: tabular-nums; color: var(--text); }
+
 .cards { min-height: 40px; display: flex; flex-direction: column; gap: 8px; flex: 1; overflow-y: auto; }
 .cards-clickable { cursor: pointer; }
 .agent-chip { color: var(--blue); }

data/app/controllers/boards_controller.rb

@@ -2,4 +2,54 @@ class BoardsController < ApplicationController
   def show
     @board = Board.includes(columns: :cards).first!
   end
+
+  # Kick off the repo deep dive (card #12). Non-blocking: flip the board into
+  # its "Working" state, morph the topbar so the button reflects it, and let
+  # DeepDiveJob do the read-only exploration in the background. Ignored if a
+  # dive is already running.
+  def deep_dive
+    board = Board.first!
+    unless board.brief_working?
+      board.update!(brief_status: "working")
+      board.broadcast_refresh_to board
+      DeepDiveJob.perform_later(board)
+    end
+    redirect_to root_path
+  end
+
+  # Cards reaching Done merge PRs on GitHub, so the checkout Cardinal runs
+  # against falls behind. The topbar Pull button fast-forwards it. --ff-only
+  # on purpose: never invent merge commits or rebase local work — if the tree
+  # has diverged, say so and let the human sort it out in a real terminal.
+  def pull
+    board = Board.first!
+    message, ok = pull_repo(board)
+    render turbo_stream: turbo_stream.update(
+      "repo-pull-status",
+      helpers.tag.span(message, class: ok ? "pull-ok" : "pull-err")
+    )
+  end
+
+  private
+
+  def pull_repo(board)
+    repo = board.local_path.presence
+    return ["No local repo path on this board", false] unless repo && Dir.exist?(File.join(repo, ".git"))
+
+    before, = Open3.capture2e("git", "-C", repo, "rev-parse", "HEAD")
+    out, status = Open3.capture2e("git", "-C", repo, "pull", "--ff-only")
+    unless status.success?
+      # Surface git's own reason (diverged, offline, auth) — the last
+      # non-blank line is usually the one that matters.
+      return [out.lines.map(&:strip).reject(&:blank?).last.to_s.truncate(120), false]
+    end
+
+    after, = Open3.capture2e("git", "-C", repo, "rev-parse", "HEAD")
+    if before.strip == after.strip
+      ["Already up to date", true]
+    else
+      count, = Open3.capture2e("git", "-C", repo, "rev-list", "--count", "#{before.strip}..#{after.strip}")
+      ["Pulled #{helpers.pluralize(count.strip.to_i, "new commit")}", true]
+    end
+  end
 end

data/app/controllers/columns_controller.rb

@@ -26,7 +26,7 @@ class ColumnsController < ApplicationController
       :name, :archetype, :instructions, :model, :effort,
       :concurrency_limit, :max_turns, :timeout_minutes, :plan_approval,
       :on_entry_text, :on_entry_json, :color, :custom_color, :arrivals, :ai,
-      accepts_from: []
+      :footer_text, accepts_from: []
     )
 
     policy = @column.policy.dup
@@ -74,6 +74,14 @@ class ColumnsController < ApplicationController
       policy.delete("on_entry_text")
     end
 
+    # Footer (card #18): one row per line as "Label | compute". A blank compute
+    # is a static label; a compute must be one Column knows how to aggregate.
+    begin
+      policy["footer"] = parse_footer(attrs[:footer_text])
+    rescue ArgumentError => e
+      return column_error(e.message)
+    end
+
     @column.update!(
       name: attrs[:name].presence || @column.name,
       archetype: new_archetype,
@@ -126,5 +134,21 @@ class ColumnsController < ApplicationController
 
   private
 
+  # "Label | compute" lines → [{"label" =>, "compute" =>}]. Returns nil when
+  # empty so the key is dropped by policy.compact. Raises ArgumentError on an
+  # unknown compute key, mirroring the on_entry validation path.
+  def parse_footer(text)
+    rows = text.to_s.lines.filter_map do |line|
+      next if line.strip.blank?
+      label, compute = line.split("|", 2).map(&:strip)
+      compute = compute.to_s
+      if compute.present? && !Column::FOOTER_COMPUTES.include?(compute)
+        raise ArgumentError, "Footer compute \"#{compute}\" is not one of: #{Column::FOOTER_COMPUTES.join(', ')}"
+      end
+      { "label" => label.to_s, "compute" => compute.presence }.compact
+    end
+    rows.presence
+  end
+
   def set_column = @column = Column.find(params[:id])
 end

data/app/helpers/application_helper.rb

@@ -26,6 +26,14 @@ module ApplicationHelper
     MARKDOWN.render(text.to_s).html_safe
   end
 
+  # Render a column's stored footer config (array of {label, compute} hashes)
+  # back into the "Label | compute" line format the gear textarea edits.
+  def footer_config_text(column)
+    Array(column.footer).map do |row|
+      [row["label"], row["compute"].presence].compact.join(" | ")
+    end.join("\n")
+  end
+
   def info_tip(text)
     tag.span("i", class: "info",
              data: { controller: "tooltip", tooltip_text_value: text,

data/app/jobs/deep_dive_job.rb

@@ -0,0 +1,64 @@
+# Opt-in repo deep dive (card #12): a one-shot, read-only agent (the same
+# cheap ClaudeCli tier the planning assistant uses — Read/Glob/Grep, no
+# workspace) that maps the board's repo into a compact "repo brief". The brief
+# is written to .cardinal/repo-brief.md and injected into every worker prompt,
+# converting the per-run exploration tax into a one-time cost.
+class DeepDiveJob < ApplicationJob
+  queue_as :default
+
+  # Enough turns to walk the tree and read a handful of key files, not enough
+  # to wander. ClaudeCli wraps up from context if it hits the cap.
+  MAX_TURNS = 30
+  FALLBACK_MODEL = "claude-haiku-4-5-20251001".freeze
+
+  PROMPT = <<~PROMPT.freeze
+    Map this repository as a concise "repo brief" for other AI agents who will
+    work in it. The whole point is to save tokens later, so be dense and skip
+    the obvious — every line must earn its place.
+
+    Explore with your read-only tools, then output ONLY flat markdown with these
+    sections (drop any that genuinely don't apply):
+
+    ## Overview
+    One short paragraph: what this project is and its shape.
+    ## Directory Structure
+    The top-level directories and what each is for (one line each).
+    ## Key Directories
+    The few places most work actually happens, and what lives there.
+    ## Build & Test
+    The exact commands to install, build, run, and test.
+    ## Key Conventions
+    Naming, patterns, and idioms an agent must follow to match the codebase.
+    ## Tech Stack
+    Languages, frameworks, and notable libraries with their role.
+    ## Gotchas
+    Non-obvious traps, footguns, and constraints worth knowing before editing.
+
+    Do not include a preamble, closing remarks, or anything outside these sections.
+  PROMPT
+
+  def perform(board)
+    repo = board.local_path.presence
+    return clear_working(board) unless ClaudeCli.available? && repo
+
+    sha = board.head_sha
+    model = board.columns.find_by(archetype: "planning")&.model.presence || FALLBACK_MODEL
+
+    brief = ClaudeCli.prompt(PROMPT, model:, tools: "Read,Glob,Grep", cwd: repo, max_turns: MAX_TURNS)
+
+    File.write(board.brief_path, brief.to_s)
+    board.update!(brief_sha: sha, brief_generated_at: Time.current,
+                  brief_model: model, brief_status: nil)
+    board.broadcast_refresh_to board
+  rescue StandardError
+    # A failed dive must not leave the button stuck on "Working" forever.
+    clear_working(board)
+  end
+
+  private
+
+  def clear_working(board)
+    board.update!(brief_status: nil)
+    board.broadcast_refresh_to board
+  end
+end

data/app/models/board.rb

@@ -83,6 +83,63 @@ class Board < ApplicationRecord
     cards.pluck(:tags).flatten.compact.uniq.sort
   end
 
+  # --- Repo brief (card #12) ---------------------------------------------
+  # A one-time deep dive that maps the repo, stored as flat markdown in
+  # .cardinal/ (never the host repo) and injected into worker prompts to
+  # spare each run the exploration tax. Metadata (which SHA/model/when) lives
+  # on the board so staleness can be judged against the current HEAD.
+  #
+  # Storage is a file + metadata, not one text column, so a structure
+  # provider (the Graphify child card) can slot a richer representation in
+  # underneath later without a migration.
+  BRIEF_STALE_AT = 10 # commits behind → the "refresh me" red/flashing state
+
+  def brief_path = Rails.root.join(".cardinal", "repo-brief.md")
+
+  def repo_brief
+    File.read(brief_path) if File.exist?(brief_path)
+  end
+
+  def brief?
+    brief_sha.present? && File.exist?(brief_path)
+  end
+
+  def brief_working? = brief_status == "working"
+
+  # HEAD of the board's repo right now — the yardstick staleness measures against.
+  def head_sha
+    return nil if local_path.blank?
+    out, ok = Open3.capture2e("git", "-C", local_path, "rev-parse", "HEAD")
+    ok.success? ? out.strip : nil
+  end
+
+  # How many commits landed since the brief was generated. nil when there's
+  # no brief (nothing to be stale against) or the SHA is unknown to the repo.
+  def commits_behind_brief
+    return @commits_behind_brief if defined?(@commits_behind_brief)
+    @commits_behind_brief =
+      if brief_sha.blank? || local_path.blank?
+        nil
+      else
+        out, ok = Open3.capture2e("git", "-C", local_path, "rev-list", "--count", "#{brief_sha}..HEAD")
+        ok.success? ? out.strip.to_i : nil
+      end
+  end
+
+  def brief_stale? = (commits_behind_brief || 0) >= BRIEF_STALE_AT
+
+  # Grey → red interpolation over 0..BRIEF_STALE_AT commits behind, emitted
+  # as a validated hex into the button's inline style (mirrors Column#safe_color).
+  # Deep red once the brief is stale enough to over-anchor on.
+  def brief_staleness_color
+    behind = commits_behind_brief || 0
+    grey = [0x8a, 0x8a, 0x8a]
+    red  = [0xd4, 0x33, 0x33]
+    t = [behind.to_f / BRIEF_STALE_AT, 1.0].min
+    rgb = grey.zip(red).map { |g, r| (g + (r - g) * t).round }
+    format("#%02x%02x%02x", *rgb)
+  end
+
   # Cards currently waiting on the human, ordered by urgency — feeds the
   # attention inbox in the board header.
   def attention_cards

data/app/models/card.rb

@@ -29,6 +29,9 @@ class Card < ApplicationRecord
   validate :status_legal_for_column
 
   before_validation :assign_number_and_position, on: :create
+  # Optional git fields left blank on the new-card form arrive as "" — store
+  # them as nil so "no PR/branch" is one state, not two ("" renders footers).
+  normalizes :branch_name, :pr_url, with: ->(v) { v.strip.presence }
 
   after_commit -> { broadcast_refresh_to board }
 

data/app/models/column.rb

@@ -35,7 +35,12 @@ class Column < ApplicationRecord
   store_accessor :policy, :instructions, :model, :effort, :concurrency_limit,
                  :plan_approval, :budget_per_run_cents, :timeout_minutes,
                  :max_turns, :tools, :on_entry, :on_success, :color, :arrivals,
-                 :accepts_from
+                 :accepts_from, :footer
+
+  # Aggregations a footer row may compute over the column's cards (card #18).
+  # A compute key not listed here renders blank, so config that outruns the
+  # code degrades gracefully instead of erroring.
+  FOOTER_COMPUTES = %w[sum_cost sum_tokens count_cards].freeze
 
   # Only ever emit a validated hex color into inline styles.
   def safe_color
@@ -58,6 +63,24 @@ class Column < ApplicationRecord
     Array(accepts_from).map(&:to_s).include?(source_column.id.to_s)
   end
 
+  # Rows rendered under the cards (card #18). Footer config is an array of
+  # {"label" => "Total cost:", "compute" => "sum_cost"} hashes; each row pairs
+  # static label text with an optional computed aggregate over this column's
+  # cards. Returns [] when unconfigured, so existing columns render no footer.
+  def footer_rows
+    rows = Array(footer).filter_map do |row|
+      label = row["label"].to_s
+      value = footer_value(row["compute"])
+      next if label.blank? && value.blank?
+      { label:, value: }
+    end
+    # AI columns advertise their active model as a final auto-row (card #32).
+    # Guarded on model presence so an AI column without one adds nothing,
+    # rather than emitting a "Model:" row with a blank value.
+    rows << { label: "Model:", value: model_short } if ai? && model.present?
+    rows
+  end
+
   # Start the next queued card when a run slot frees up. A queued card whose
   # run parked and already has its answer recorded resumes instead of
   # starting fresh.
@@ -90,6 +113,21 @@ class Column < ApplicationRecord
     execution? && concurrency_limit.present? && running_count >= concurrency_limit.to_i
   end
 
+  # Aggregate a single footer row over the runs/cards in this column (card #18).
+  # Unknown keys return "" so the row shows just its static label.
+  def footer_value(compute)
+    case compute.to_s
+    when "sum_cost"
+      "$%.2f" % column_runs.sum(:cost)
+    when "sum_tokens"
+      ActiveSupport::NumberHelper.number_to_delimited(column_runs.sum("input_tokens + output_tokens"))
+    when "count_cards"
+      cards.count.to_s
+    else
+      ""
+    end
+  end
+
   # The built-in role contract for AI servicing this archetype — shown
   # read-only in the gear modal so the Instructions field is understood as
   # ADDING to this, never replacing it. Enforced in code, not editable.
@@ -131,4 +169,11 @@ class Column < ApplicationRecord
     when "terminal"  then "Closes it — PR merged and branch deleted, if there is one"
     end
   end
+
+  private
+
+  # Every run belonging to a card in this column, for footer aggregation.
+  def column_runs
+    Run.joins(agent_session: :card).where(cards: { column_id: id })
+  end
 end

data/app/services/agent/runner.rb

@@ -329,7 +329,7 @@ module Agent
         ## Brief
         #{card.description.presence || "(no description — infer scope from the title and conversation)"}
 
-        #{"## Brief from planning (authoritative — refined with the user)\n#{planning_brief}\n" if planning_brief}
+        #{repo_brief_section}#{"## Brief from planning (authoritative — refined with the user)\n#{planning_brief}\n" if planning_brief}
         ## Card conversation so far
         #{conversation_excerpt.presence || "(none)"}
 
@@ -346,7 +346,7 @@ module Agent
         ## Brief
         #{card.description.presence || "(no description — infer scope from the title and conversation)"}
 
-        #{"## Brief from planning (authoritative — refined with the user)\n#{planning_brief}\n" if planning_brief}
+        #{repo_brief_section}#{"## Brief from planning (authoritative — refined with the user)\n#{planning_brief}\n" if planning_brief}
         ## Card conversation so far
         #{conversation_excerpt.presence || "(none)"}
 
@@ -363,6 +363,14 @@ module Agent
       PROMPT
     end
 
+    # The one-time repo deep dive (card #12), injected ahead of the planning
+    # brief so the agent starts oriented instead of re-exploring the tree each
+    # run. Empty string (not nil) when there's no brief, so the heredoc stays clean.
+    def repo_brief_section
+      brief = card.board.repo_brief.presence or return ""
+      "## Repo brief\n#{brief.strip}\n\n"
+    end
+
     # The planning assistant's distilled "Ready for execution" brief, if the
     # conversation produced one — the most load-bearing artifact of planning.
     def planning_brief

data/app/views/boards/show.html.erb

@@ -1,8 +1,31 @@
 <%= turbo_stream_from @board %>
 
 <header class="topbar">
-  <h1>Cardinal AI <span class="sep">▸</span> <%= @board.name %></h1>
+  <div class="topbar-left">
+    <h1>Cardinal AI <span class="sep">▸</span> <%= @board.name %></h1>
+    <%= button_to "⇣ Pull", pull_board_path, form_class: "pull-form",
+          form: { title: "git pull --ff-only in #{@board.local_path} — fetch what Done has merged" },
+          data: { turbo_submits_with: "⇣ Pulling…" }, class: "theme-toggle" %>
+    <span id="repo-pull-status"></span>
+  </div>
   <div class="topbar-right">
+    <%# Repo deep dive (card #12): one-shot read-only mapping of the repo, stored
+        as a brief and injected into worker prompts. The button greys→reds as the
+        brief falls behind HEAD; a stale brief over-anchors, so it nags at 10+. %>
+    <% behind = @board.commits_behind_brief %>
+    <%= button_to deep_dive_board_path,
+          class: "deep-dive#{' stale-critical' if @board.brief_stale?}#{' working' if @board.brief_working?}",
+          disabled: @board.brief_working?,
+          style: @board.brief? ? "color: #{@board.brief_staleness_color}; border-color: #{@board.brief_staleness_color}" : nil,
+          title: @board.brief? ? "Repo brief from #{@board.brief_sha&.first(7)} · #{@board.brief_generated_at&.to_date}" : "Map this repo into a brief agents reuse — saves exploration on every run" do %>
+      <% if @board.brief_working? %>
+        <span class="pulse-dot"></span> Deep dive · working…
+      <% elsif behind&.positive? %>
+        🔍 Deep dive · <%= behind %> commit<%= "s" if behind != 1 %> behind
+      <% else %>
+        🔍 Deep dive
+      <% end %>
+    <% end %>
     <button type="button" class="theme-toggle"
             data-controller="theme" data-action="theme#toggle">☀ Light</button>
     <% if ENV["CARDINAL_AUTH"].present? %>

data/app/views/cards/_card.html.erb

@@ -36,10 +36,10 @@
       <% end %>
       <% if card.parent_id %><span class="chip">↑ sub</span><% end %>
       <% if card.children.any? %><span class="chip">↳ <%= card.children.where(status: %w[done archived]).count %>/<%= card.children.count %></span><% end %>
-      <% if card.branch_name && card.pr_url.blank? %><span class="chip branch">🌿 <%= card.branch_name.delete_prefix("cardinal/") %></span><% end %>
+      <% if card.branch_name.present? && card.pr_url.blank? %><span class="chip branch">🌿 <%= card.branch_name.delete_prefix("cardinal/") %></span><% end %>
     </div>
   <% end %>
-  <% if card.pr_url %>
+  <% if card.pr_url.present? %>
     <a class="card-footer" href="<%= card.pr_url %>" target="_blank" rel="noopener" title="Open the pull request on GitHub">
       <span class="footer-left"><%# future: Asana / Trello / linked-ticket slot %></span>
       <span class="footer-pr">GitHub #<%= card.pr_url[%r{/pull/(\d+)}, 1] %> ↗</span>

data/app/views/cards/_detail.html.erb

@@ -8,7 +8,7 @@
           <span class="card-number-sub" title="Card number — how branches, PRs, and other cards refer to this card">#<%= @card.number %></span>
         </h1>
         <div class="modal-header-right">
-          <% if @card.branch_name %>
+          <% if @card.branch_name.present? %>
             <span class="git-line">
               <span class="branch-base"><%= @card.board.default_branch %></span>
               <span class="git-arrow">→</span>
@@ -17,7 +17,7 @@
                 <button type="button" class="copy-btn" data-clipboard-target="button"
                         data-action="clipboard#copy" title="Copy branch name">⧉</button>
               </span>
-              <% if @card.pr_url %>
+              <% if @card.pr_url.present? %>
                 <span class="git-arrow">→</span>
                 <%= link_to "##{@card.pr_url[%r{/pull/(\d+)}, 1]}", @card.pr_url, target: "_blank", rel: "noopener", class: "pr-link" %>
                 <% if @card.pr_state.present? %><span class="pr-state">(<%= @card.pr_state %>)</span><% end %>
@@ -113,7 +113,7 @@
 
           <% if @card.column.review? %>
             <h3>Review</h3>
-            <% if @card.pr_url %>
+            <% if @card.pr_url.present? %>
               <%= link_to "View Pull Request", @card.pr_url, target: "_blank", rel: "noopener", class: "pr-view-btn" %>
             <% end %>
             <% if @card.in_review? %>
@@ -168,7 +168,7 @@
                 </li>
               <% end %>
             </ul>
-            <% if @card.pr_url %>
+            <% if @card.pr_url.present? %>
               <p>🌿 <%= link_to "View pull request", @card.pr_url, target: "_blank" %><%= " (#{@card.pr_state})" if @card.pr_state.present? %></p>
             <% end %>
           <% else %>

data/app/views/columns/_column.html.erb

@@ -22,4 +22,15 @@
       <%= render "cards/card", card: card %>
     <% end %>
   </div>
+  <% rows = column.footer_rows %>
+  <% if rows.any? %>
+    <footer class="column-footer">
+      <% rows.each do |row| %>
+        <div class="footer-row">
+          <span class="footer-label"><%= row[:label] %></span>
+          <span class="footer-value"><%= row[:value] %></span>
+        </div>
+      <% end %>
+    </footer>
+  <% end %>
 </section>

data/app/views/columns/edit.html.erb

@@ -125,6 +125,11 @@
             </details>
           </div>
           <% end %>
+
+          <label>Footer <%= info_tip("A summary strip under the cards. One row per line as \"Label | compute\", where compute is sum_cost (total run cost), sum_tokens (total input+output tokens), count_cards, or blank for a static label. Example: \"Total cost: | sum_cost\".") %></label>
+          <%= f.text_area :footer_text, rows: 3, class: "mono",
+                value: footer_config_text(@column),
+                placeholder: "Total cost: | sum_cost" %>
         <% end %>
 
         <details class="advanced-rules panel-advanced">

data/config/routes.rb

@@ -1,7 +1,10 @@
 Rails.application.routes.draw do
   root "boards#show"
 
-  resource :board, only: :show
+  resource :board, only: :show do
+    post :deep_dive
+    post :pull
+  end
   resources :cards, only: [:new, :create, :show, :update, :destroy] do
     member do
       patch :move

data/db/migrate/20260704120000_add_repo_brief_to_boards.rb

@@ -0,0 +1,8 @@
+class AddRepoBriefToBoards < ActiveRecord::Migration[8.1]
+  def change
+    add_column :boards, :brief_sha, :string
+    add_column :boards, :brief_generated_at, :datetime
+    add_column :boards, :brief_model, :string
+    add_column :boards, :brief_status, :string
+  end
+end

data/lib/cardinal/version.rb

@@ -1,3 +1,3 @@
 module Cardinal
-  VERSION = "0.2.4"
+  VERSION = "0.2.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cardinal-ai
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.5
 platform: ruby
 authors:
 - Jason Ellis
@@ -157,6 +157,7 @@ files:
 - app/jobs/ai_task_job.rb
 - app/jobs/application_job.rb
 - app/jobs/assistant_reply_job.rb
+- app/jobs/deep_dive_job.rb
 - app/jobs/mark_pr_ready_job.rb
 - app/jobs/merge_pr_job.rb
 - app/jobs/resume_run_job.rb
@@ -222,6 +223,7 @@ files:
 - db/migrate/20260703000002_add_agent_runner_fields.rb
 - db/migrate/20260704000001_add_parent_to_cards.rb
 - db/migrate/20260704000002_add_assistant_session_to_cards.rb
+- db/migrate/20260704120000_add_repo_brief_to_boards.rb
 - db/seeds.rb
 - docker/agent/Dockerfile
 - exe/cardinal