cardinal-ai 0.2.6 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '079e999400eeaa39a8e7f7d8efdc4b3b114923cf0aaf190dcd15a6117a97d7b2'
-  data.tar.gz: 61343cc2e5c42fbf43f3eeb223da83af60d1e634f8424e69d032c9afd287aa02
+  metadata.gz: 644f883c694c74ad5189ef319f46beaf3e679a7aa47ae43be9bb316560ba46cf
+  data.tar.gz: a54a728cece60d820acbaef2ad4abdcb8080d4fd888f122700f1266f85b9713f
 SHA512:
-  metadata.gz: 1acb0d147c37615d1daf946a8e3aebbbdec636511cf6781a835ed4b73b61b1f3b57aff903273b160b75df66b263857cc83e7ef38f8b71841a7f8f3ebea8877e6
-  data.tar.gz: 5ab7bddf1b68f55466825914a1d0eb7a697e02a5c7e0e3a4d0dcfe306ee673c65a17f9f5e2bf09425c002ccd02809d32ce30e2f0a2ececdd2c93b8d0139932c5
+  metadata.gz: c4d36b5b5fc1936cdea3946cc53977708d15c2035fd1e6e54cf9f5d06679d8c1e40fa056e8e955ffa3f9447bc7c8213c990ebcb581ecf862d44fc57b8b0d01d8
+  data.tar.gz: 840bb89331ac1d362b81a6194d5887f1729702274e217fd921af5493bffd05f32a0047607b2a4ca0b72046ba4263cb85e93e2f770c3adb499fc703c298ef93b7

data/app/assets/stylesheets/cardinal.css

@@ -215,7 +215,18 @@ body.dragging .drop-hint { display: block; }
   font-size: 11px; color: var(--text-dim); font-weight: 600;
 }
 .card-footer:hover .footer-pr { color: var(--blue); }
-.footer-left { min-width: 1px; }
+.footer-left { min-width: 1px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.footer-center { min-width: 1px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: center; }
+.footer-cost { white-space: nowrap; flex-shrink: 0; }
+.footer-pr { color: var(--text-dim); flex-shrink: 0; }
+
+/* Open-card cost tally: sits at the foot of the work panel, live-updating. */
+.work-footer {
+  display: flex; justify-content: space-between; align-items: center; gap: 8px;
+  margin-top: 16px; padding-top: 10px; border-top: 1px solid var(--border);
+  font-size: 12px; color: var(--text-dim); font-weight: 600;
+}
+.work-footer .footer-cost { white-space: nowrap; }
 .card-ghost { opacity: .4; }
 .card-title { font-weight: 600; }
 .card-number { color: var(--text-dim); font-weight: 400; }
@@ -374,6 +385,16 @@ body.dragging .drop-hint { display: block; }
 .zoom-tabs a { padding: 4px 12px; border-radius: 6px; color: var(--text-dim); }
 .zoom-tabs a.active { background: var(--surface-2); color: var(--text); }
 
+.summary-panel .summary-head { display: flex; align-items: center; justify-content: space-between; gap: 10px; }
+.summary-panel .summary-head h3 { margin: 0; }
+.summary-generate { white-space: nowrap; }
+.summary-blurb { margin: 6px 0 12px; }
+.summary-form textarea {
+  width: 100%; background: var(--surface-2); border: 1px solid var(--border);
+  border-radius: 6px; color: var(--text); padding: 8px 10px; font: inherit; resize: vertical;
+}
+.summary-stamp { margin-top: 8px; }
+
 .event { display: flex; gap: 10px; padding: 8px 4px; border-bottom: 1px solid var(--surface-2); }
 
 /* Column moves are chapter markers in the card's story */

data/app/controllers/boards_controller.rb

@@ -60,10 +60,19 @@ class BoardsController < ApplicationController
   def pull
     board = Board.first!
     message, ok = pull_repo(board)
-    render turbo_stream: turbo_stream.update(
+    streams = [turbo_stream.update(
       "repo-pull-status",
       helpers.tag.span(message, class: ok ? "pull-ok" : "pull-err")
-    )
+    )]
+    if @pulled_commits
+      # New code often means new JS (Stimulus controllers, importmap entries)
+      # that an already-open tab will never fetch — Turbo morphs keep the page
+      # alive on stale assets forever. A pull is a deliberate "give me the new
+      # version", so finish the job with a full reload.
+      streams << turbo_stream.append("repo-pull-status",
+        helpers.tag.script("setTimeout(() => window.location.reload(), 1200)".html_safe))
+    end
+    render turbo_stream: streams
   end
 
   private
@@ -87,7 +96,8 @@ class BoardsController < ApplicationController
       count, = Open3.capture2e("git", "-C", repo, "rev-list", "--count", "#{before.strip}..#{after.strip}")
       migrated = run_pending_migrations
       note = migrated.positive? ? " · ran #{helpers.pluralize(migrated, "migration")}" : ""
-      ["Pulled #{helpers.pluralize(count.strip.to_i, "new commit")}#{note}", true]
+      @pulled_commits = true
+      ["Pulled #{helpers.pluralize(count.strip.to_i, "new commit")}#{note} · reloading…", true]
     end
   end
 

data/app/controllers/cards_controller.rb

@@ -1,5 +1,5 @@
 class CardsController < ApplicationController
-  before_action :set_card, only: [:show, :update, :move, :approve, :destroy]
+  before_action :set_card, only: [:show, :update, :move, :approve, :summarize, :compact, :destroy]
 
   def new
     @board = Board.first!
@@ -30,10 +30,11 @@ class CardsController < ApplicationController
   end
 
   def show
-    @zoom = params[:zoom].presence_in(%w[conversation activity debug]) || "conversation"
+    @zoom = params[:zoom].presence_in(%w[conversation activity debug summary compact]) || "conversation"
     @events = case @zoom
               when "conversation" then @card.events.conversation
               when "activity" then @card.events.activity
+              when "summary", "compact" then Event.none # these tabs show a card panel, not events
               else @card.events
               end
 
@@ -80,7 +81,46 @@ class CardsController < ApplicationController
       @card.update!(status: "approved")
       @card.log!("status_change", actor: "user", text: "Work approved — drag to Done to ship")
     end
-    redirect_to card_path(@card)
+
+    respond_to do |format|
+      # Flash the verdict in place, then let the dismiss controller minimize the
+      # modal. Patch the board face too — Turbo suppresses this tab's own refresh
+      # broadcast, so without this the card keeps its stale status once we close.
+      format.turbo_stream do
+        render turbo_stream: [
+          turbo_stream.replace(helpers.dom_id(@card), partial: "cards/card", locals: { card: @card }),
+          turbo_stream.replace("review-callout", partial: "cards/dismiss_flash",
+                                                  locals: { message: "Approved — closing…" })
+        ]
+      end
+      format.html { redirect_to card_path(@card) }
+    end
+  end
+
+  # Generate a customer-friendly summary on demand (card #35). Non-blocking,
+  # mirroring the board's deep dive: flip the card into its "working" state,
+  # morph the Summary panel so the button reflects it, and let SummaryJob do the
+  # one-shot synthesis in the background. Skipped when one is already running.
+  def summarize
+    unless @card.summary_working?
+      @card.update!(summary_status: "working")
+      SummaryJob.perform_later(@card)
+    end
+    render turbo_stream: turbo_stream.replace("card_summary",
+             partial: "cards/summary_panel", locals: { card: @card })
+  end
+
+  # Generate a technical "compact" journal on demand (card #34). The AI-readable
+  # mirror of #summarize: flip the card into its "working" state, morph the Compact
+  # panel so the button reflects it, and let CompactJob do the one-shot synthesis
+  # in the background. Skipped when one is already running.
+  def compact
+    unless @card.compact_working?
+      @card.update!(compact_status: "working")
+      CompactJob.perform_later(@card)
+    end
+    render turbo_stream: turbo_stream.replace("card_compact",
+             partial: "cards/compact_panel", locals: { card: @card })
   end
 
   def move
@@ -106,7 +146,7 @@ class CardsController < ApplicationController
   end
 
   def card_params
-    attrs = params.require(:card).permit(:title, :description, :tags, :branch_name, :pr_url)
+    attrs = params.require(:card).permit(:title, :description, :tags, :branch_name, :pr_url, :summary, :compact)
     attrs[:tags] = attrs[:tags].to_s.split(",").map(&:strip).reject(&:blank?) if attrs.key?(:tags)
     attrs.to_h.symbolize_keys
   end
@@ -114,7 +154,7 @@ class CardsController < ApplicationController
   # Changelog in the activity timeline (the mechanism already exists). A burst
   # of autosaves coalesces into one entry instead of one per pause-in-typing.
   def log_changelog!
-    changed = @card.previous_changes.keys & %w[title description tags branch_name pr_url]
+    changed = @card.previous_changes.keys & %w[title description tags branch_name pr_url summary compact]
     return if changed.empty?
 
     last = @card.events.order(:id).last

data/app/controllers/runs_controller.rb

@@ -21,7 +21,17 @@ class RunsController < ApplicationController
       card.log!("plan_approved", actor: "user", run: run, text: "Plan approved")
       ResumeRunJob.perform_later(run.id, "", approve: true)
     end
-    redirect_to card_path(card)
+
+    respond_to do |format|
+      # Flash the approval in place, then the dismiss controller minimizes the
+      # modal. The run advances asynchronously (ResumeRunJob), so there's no
+      # synchronous card state to morph here — just confirm and close.
+      format.turbo_stream do
+        render turbo_stream: turbo_stream.replace("plan-callout", partial: "cards/dismiss_flash",
+                                                                  locals: { message: "Plan approved — running…" })
+      end
+      format.html { redirect_to card_path(card) }
+    end
   end
 
   # Restart a run that parked or failed on its turn budget / timeout. Mirrors

data/app/javascript/controllers/dismiss_controller.js

@@ -0,0 +1,23 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Briefly show a confirmation, then minimize the surrounding card modal.
+// Rendered into an approval callout so the user sees the verdict land before
+// the card snaps back to the columns view. On connect we start a timer; when
+// it fires we hand off to the enclosing modal controller's close().
+export default class extends Controller {
+  static values = { delay: { type: Number, default: 1100 } }
+
+  connect() {
+    this.timer = setTimeout(() => this.dismiss(), this.delayValue)
+  }
+
+  disconnect() {
+    clearTimeout(this.timer)
+  }
+
+  dismiss() {
+    const el = this.element.closest("[data-controller~='modal']")
+    if (!el) return
+    this.application.getControllerForElementAndIdentifier(el, "modal")?.close()
+  }
+}

data/app/jobs/compact_job.rb

@@ -0,0 +1,97 @@
+# On-demand, AI-readable "compact" of a card (card #34): the technical mirror of
+# SummaryJob. Where Summary compresses a card into a couple of non-technical lines
+# for a customer chat, Compact distills everything that happened — the brief,
+# timeline, runs, final reports, and code commits — into a dense technical journal
+# a *resuming agent* can read instead of re-exploring the repo and re-deriving
+# context. That's the whole point: spend a few tokens now to save many later.
+# Generation is user-triggered only; the result persists on the card and stays
+# fully editable. A prior compact (possibly hand-edited) rides along as context so
+# a regeneration refines rather than discards what the user kept.
+class CompactJob < ApplicationJob
+  queue_as :default
+
+  FALLBACK_MODEL = "claude-haiku-4-5-20251001".freeze
+
+  SYSTEM = <<~SYS.freeze
+    You write a dense, technical engineering journal for an AI agent that will
+    resume work on this card later. Your reader is a machine, not a customer:
+    optimize for signal, not readability. Capture, in compact form, everything a
+    resuming engineer needs so they do NOT have to re-explore the repo or re-derive
+    context — what was built and how, files and components touched, key APIs and
+    libraries used, decisions made and the reasons behind them, issues found,
+    blockers hit, and anything left unfinished or deliberately deferred. Prefer
+    terse structured notes (short headings, bullets, file paths, symbol names) over
+    prose. Omit pleasantries and customer-facing framing. Write only the journal.
+  SYS
+
+  def perform(card)
+    return clear_working(card) unless ClaudeCli.available?
+
+    model = card.board.columns.find_by(archetype: "planning")&.model.presence || FALLBACK_MODEL
+    compact = ClaudeCli.prompt(build_prompt(card), system: SYSTEM, model: model, max_turns: 1)
+
+    card.update!(compact: compact.to_s.strip, compact_generated_at: Time.current, compact_status: nil)
+    card.broadcast_replace_to card, target: "card_compact",
+                              partial: "cards/compact_panel", locals: { card: card }
+  rescue StandardError
+    # A failed generation must not leave the button stuck on "Generating…".
+    clear_working(card)
+  end
+
+  private
+
+  def clear_working(card)
+    card.update!(compact_status: nil)
+    card.broadcast_replace_to card, target: "card_compact",
+                              partial: "cards/compact_panel", locals: { card: card }
+  end
+
+  def build_prompt(card)
+    parts = ["Card ##{card.number}: #{card.title}"]
+    parts << "Tags: #{card.tags.join(", ")}" if card.tags.any?
+    parts << "\nBrief / description:\n#{card.description}" if card.description.present?
+
+    timeline = card.events.activity.filter_map { |e| event_line(e) }
+    parts << "\nWhat happened (technical timeline):\n#{timeline.join("\n")}" if timeline.any?
+
+    reports = card.events.where(kind: "final_report").filter_map(&:text).map(&:strip).reject(&:blank?)
+    parts << "\nFinal reports from runs:\n#{reports.join("\n\n---\n\n")}" if reports.any?
+
+    runs = card.runs.order(:id).map { |r| "- Run ##{r.id}: #{r.status}#{" (#{r.phase})" if r.phase.present?}" }
+    parts << "\nRuns:\n#{runs.join("\n")}" if runs.any?
+
+    commits = commit_lines(card)
+    parts << "\nCode changes (commit messages):\n#{commits.join("\n")}" if commits.any?
+
+    if card.compact.present?
+      parts << "\nThe existing technical compact is below. It may have been edited by hand, " \
+               "so preserve details the user kept and fold in any new work rather than " \
+               "starting from scratch:\n#{card.compact}"
+    end
+
+    parts.join("\n")
+  end
+
+  def event_line(event)
+    text = event.text.to_s.strip
+    return nil if text.blank?
+    "- #{event.actor}: #{text.truncate(600)}"
+  end
+
+  # Commit messages for the card's branch, read from the per-card workspace
+  # checkout when it still exists. The checkout isn't guaranteed to be present
+  # (it's left in place after a run but may be pruned), so this is best-effort —
+  # the timeline already narrates the work when commits are unavailable.
+  def commit_lines(card)
+    return [] if card.branch_name.blank?
+    path = Agent::Workspace::Local.new(card).path
+    return [] unless File.directory?(path.join(".git"))
+
+    base = "origin/#{card.board.default_branch}"
+    out, ok = Open3.capture2e("git", "-C", path.to_s, "log", "--oneline", "--no-decorate", "#{base}..HEAD")
+    return [] unless ok.success?
+    out.lines.map(&:strip).reject(&:blank?).map { |l| "- #{l}" }
+  rescue StandardError
+    []
+  end
+end

data/app/jobs/summary_job.rb

@@ -0,0 +1,88 @@
+# On-demand, customer-friendly card summary (card #35): a one-shot, tool-less
+# Claude call (the same cheap tier the planning assistant and deep dive use)
+# that compresses everything a card did — its brief, timeline, runs, and code
+# commits — into a couple of non-technical lines you can drop into a customer
+# chat. Generation is user-triggered only; the result persists on the card and
+# stays fully editable. A prior summary (possibly hand-edited) rides along as
+# context so a regeneration refines rather than discards what the user cared about.
+class SummaryJob < ApplicationJob
+  queue_as :default
+
+  FALLBACK_MODEL = "claude-haiku-4-5-20251001".freeze
+
+  SYSTEM = <<~SYS.freeze
+    You write short, non-technical status updates for customers. Given everything
+    that happened on a work item, produce a plain-language recap the reader can
+    drop straight into a Teams or Slack message — what was asked for and what was
+    delivered, in outcome terms. No jargon, no file names, no code, no headings.
+    A couple of sentences up to a short paragraph. Write only the recap itself.
+  SYS
+
+  def perform(card)
+    return clear_working(card) unless ClaudeCli.available?
+
+    model = card.board.columns.find_by(archetype: "planning")&.model.presence || FALLBACK_MODEL
+    summary = ClaudeCli.prompt(build_prompt(card), system: SYSTEM, model: model, max_turns: 1)
+
+    card.update!(summary: summary.to_s.strip, summary_generated_at: Time.current, summary_status: nil)
+    card.broadcast_replace_to card, target: "card_summary",
+                              partial: "cards/summary_panel", locals: { card: card }
+  rescue StandardError
+    # A failed generation must not leave the button stuck on "Generating…".
+    clear_working(card)
+  end
+
+  private
+
+  def clear_working(card)
+    card.update!(summary_status: nil)
+    card.broadcast_replace_to card, target: "card_summary",
+                              partial: "cards/summary_panel", locals: { card: card }
+  end
+
+  def build_prompt(card)
+    parts = ["Work item ##{card.number}: #{card.title}"]
+    parts << "Tags: #{card.tags.join(", ")}" if card.tags.any?
+    parts << "\nDescription:\n#{card.description}" if card.description.present?
+
+    timeline = card.events.activity.filter_map { |e| event_line(e) }
+    parts << "\nWhat happened (timeline):\n#{timeline.join("\n")}" if timeline.any?
+
+    runs = card.runs.order(:id).map { |r| "- Run ##{r.id}: #{r.status}#{" (#{r.phase})" if r.phase.present?}" }
+    parts << "\nRuns:\n#{runs.join("\n")}" if runs.any?
+
+    commits = commit_lines(card)
+    parts << "\nCode changes (commit messages):\n#{commits.join("\n")}" if commits.any?
+
+    if card.summary.present?
+      parts << "\nThe user's current summary is below. They may have edited it by hand, " \
+               "so treat its wording and emphasis as a signal of what they care about — " \
+               "refine and update it with any new work rather than starting from scratch:\n#{card.summary}"
+    end
+
+    parts.join("\n")
+  end
+
+  def event_line(event)
+    text = event.payload["text"].to_s.strip
+    return nil if text.blank?
+    "- #{event.actor}: #{text.truncate(400)}"
+  end
+
+  # Commit messages for the card's branch, read from the per-card workspace
+  # checkout when it still exists. The checkout isn't guaranteed to be present
+  # (it's left in place after a run but may be pruned), so this is best-effort —
+  # the timeline already narrates the work when commits are unavailable.
+  def commit_lines(card)
+    return [] if card.branch_name.blank?
+    path = Agent::Workspace::Local.new(card).path
+    return [] unless File.directory?(path.join(".git"))
+
+    base = "origin/#{card.board.default_branch}"
+    out, ok = Open3.capture2e("git", "-C", path.to_s, "log", "--oneline", "--no-decorate", "#{base}..HEAD")
+    return [] unless ok.success?
+    out.lines.map(&:strip).reject(&:blank?).map { |l| "- #{l}" }
+  rescue StandardError
+    []
+  end
+end

data/app/models/board.rb

@@ -10,6 +10,7 @@ class Board < ApplicationRecord
       policy: { "ai" => true, "model" => "claude-haiku-4-5-20251001", "plan_approval" => false,
                 "on_entry" => [{ "action" => "assistant_greeting" }],
                 "on_entry_text" => "The planning assistant reads the card and opens the discussion.",
+                "footer" => [{ "label" => "Model:", "compute" => "model" }],
                 "accepts_from_names" => ["Tasks", "In Progress", "Review", "QA"] } },
     { name: "In Progress", archetype: "execution",
       policy: { "ai" => true, "model" => "claude-opus-4-8", "effort" => "high",
@@ -18,6 +19,7 @@ class Board < ApplicationRecord
                 "tools" => %w[read edit run_commands git_commit_push],
                 "on_entry" => [{ "action" => "start_agent_run" }],
                 "accepts_from_names" => ["Planning", "Review", "QA"],
+                "footer" => [{ "label" => "Model:", "compute" => "model" }],
                 "instructions" => "Follow repo conventions. Write tests when the repo has a suite." } },
     { name: "Review",      archetype: "review",
       policy: { "ai" => true, "plan_approval" => false,

data/app/models/card.rb

@@ -23,6 +23,15 @@ class Card < ApplicationRecord
   has_many :agent_sessions, dependent: :destroy
   has_many :runs, through: :agent_sessions
 
+  # Card-face status glyphs. Keyed on status, except `ready_for_approval?`
+  # (a derived plan-park state, not a status) which pre-empts the ❓ below.
+  STATUS_GLYPHS = {
+    "working" => "⚡", "needs_input" => "❓", "failed" => "✖",
+    "work_complete" => "✅", "done" => "✓", "queued" => "⏳",
+    "discussing" => "💬", "in_review" => "👁", "approved" => "👍",
+    "changes_requested" => "🔁"
+  }.freeze
+
   enum :status, STATUSES.index_by(&:itself)
 
   validates :title, presence: true
@@ -39,13 +48,39 @@ class Card < ApplicationRecord
 
   def needs_attention? = %w[needs_input blocked failed work_complete].include?(status)
 
+  # A customer-friendly summary is being (re)generated in the background (§card #35).
+  def summary_working? = summary_status == "working"
+
+  # A technical "compact" journal is being (re)generated in the background (§card
+  # #34) — the AI-readable context a resuming agent reads to skip re-exploration.
+  def compact_working? = compact_status == "working"
+
   def running? = %w[queued working needs_input].include?(status)
 
+  # The agent has proposed a plan and is parked waiting on the user's approve
+  # click — distinct from a genuine question. Same underlying `needs_input`
+  # status; the plan-phase park is the signal (mirrors the work panel, §detail).
+  # The status guard means the run query only fires for already-parked cards.
+  def ready_for_approval?
+    needs_input? && runs.needs_input.order(:id).last&.phase == "plan"
+  end
+
+  # Card-face glyph: a bell when a plan is awaiting approval, else the plain
+  # per-status mapping.
+  def status_glyph
+    ready_for_approval? ? "🔔" : STATUS_GLYPHS[status]
+  end
+
   # Latest one-line progress event, shown live on the card face (§6).
   def latest_progress
     events.where(kind: "progress").last&.payload&.[]("text")
   end
 
+  # Running tally across every run on the card — the closed-card cost footer
+  # (card #20). Sums stopped/restarted segments so the total reflects real spend.
+  def total_cost = runs.sum(:cost)
+  def total_output_tokens = runs.sum(:output_tokens)
+
   # Is the planning assistant expected to post next? True right after entering
   # a planning column (kickoff inspection pending) or after a user message.
   def awaiting_assistant?

data/app/models/column.rb

@@ -40,7 +40,7 @@ class Column < ApplicationRecord
   # 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
+  FOOTER_COMPUTES = %w[sum_cost sum_tokens count_cards model].freeze
 
   # Only ever emit a validated hex color into inline styles.
   def safe_color
@@ -76,18 +76,15 @@ class Column < ApplicationRecord
   # {"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.
+  # No auto-rows (de-magic): the model row that used to be hardcoded for AI
+  # columns is now the "model" compute — visible in the gear, deletable.
   def footer_rows
-    rows = Array(footer).filter_map do |row|
+    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
@@ -112,6 +109,14 @@ class Column < ApplicationRecord
     model.to_s[/claude-([a-z]+)/, 1] || model
   end
 
+  # "Opus - High" — human label for cost footers (card #20). Effort is optional,
+  # so a model with no configured effort renders just "Opus".
+  def model_label
+    return if model.blank?
+    label = model_short.to_s.capitalize
+    effort.present? ? "#{label} - #{effort.to_s.capitalize}" : label
+  end
+
   validates :name, presence: true
   validates :position, presence: true
 
@@ -138,6 +143,10 @@ class Column < ApplicationRecord
       ActiveSupport::NumberHelper.number_to_delimited(column_runs.sum("input_tokens + output_tokens"))
     when "count_cards"
       cards.count.to_s
+    when "model"
+      # The column's active AI model, short form. Blank when AI is off or no
+      # model is set — the row then shows just its label, telling the truth.
+      ai? ? model_short.to_s : ""
     else
       ""
     end

data/app/services/agent/runner.rb

@@ -356,7 +356,7 @@ module Agent
         ## Card conversation so far
         #{conversation_excerpt.presence || "(none)"}
 
-        #{"## Column instructions\n#{column.instructions}\n" if column.instructions.present?}
+        #{compact_section}#{"## Column instructions\n#{column.instructions}\n" if column.instructions.present?}
         #{execute_rules}
       PROMPT
     end
@@ -377,7 +377,7 @@ module Agent
         ## Card conversation so far
         #{conversation_excerpt.presence || "(none)"}
 
-        #{"## Column instructions\n#{column.instructions}\n" if column.instructions.present?}
+        #{compact_section}#{"## Column instructions\n#{column.instructions}\n" if column.instructions.present?}
         Explore the repository as needed, then present a short numbered plan-of-attack
         (files you'll touch, approach, how you'll verify) and stop. The user will approve
         or redirect before any changes are made.
@@ -398,6 +398,25 @@ module Agent
       "## Repo brief\n#{brief.strip}\n\n"
     end
 
+    # The user-generated technical "compact" (card #34), if one exists — a dense
+    # journal of prior work on this card written for a resuming agent. Injected so
+    # the agent picks up where the last session left off instead of re-deriving
+    # context. Explicitly framed as technical resume notes, distinct from the
+    # human conversation above and from the customer-facing summary. Empty string
+    # (not nil) when absent, so the heredoc stays clean.
+    def compact_section
+      compact = card.compact.presence or return ""
+      <<~SECTION
+        ## Technical resume context (compact from a prior work session)
+        The notes below were generated (and possibly hand-edited) to capture the
+        technical state of prior work on this card — what was built, decided, and
+        blocked. Treat them as an authoritative shortcut to avoid re-exploring the
+        repo; verify against the actual code before relying on any specific detail.
+        #{compact.strip}
+
+      SECTION
+    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/brief.html.erb

@@ -35,7 +35,7 @@
 
         <div class="card-edit-actions">
           <%= button_to "↻ Regenerate brief", deep_dive_board_path(force: 1),
-                form: { data: { turbo_frame: "_top" } },
+                form: { data: { turbo_frame: "_top", action: "turbo:submit-end->modal#closeOnSuccess" } },
                 disabled: @board.brief_working? %>
         </div>
         <p class="hint">

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

@@ -2,10 +2,7 @@
   <%= link_to card_path(card), class: "card-link", data: { turbo_frame: "modal", turbo_action: "advance" } do %>
     <div class="card-title">
       <%= card.title %>
-      <span class="status-glyph"><%= { "working" => "⚡", "needs_input" => "❓", "failed" => "✖",
-                                       "work_complete" => "✅", "done" => "✓", "queued" => "⏳",
-                                       "discussing" => "💬", "in_review" => "👁", "approved" => "👍",
-                                       "changes_requested" => "🔁" }[card.status] %></span>
+      <span class="status-glyph"><%= card.status_glyph %></span>
     </div>
     <% if card.queued? %>
       <% ahead = card.column.cards.where(status: "queued").where("position < ?", card.position).count %>
@@ -23,26 +20,26 @@
     <% end %>
     <div class="card-meta">
       <% card.tags.each do |tag| %><span class="tag"><%= tag %></span><% end %>
-      <% if card.running? && card.column.ai? && card.column.model %>
-        <span class="chip agent-chip">🤖 <%= card.column.model_short %><%= " · #{card.column.effort}" if card.column.effort %></span>
-      <% end %>
       <% if card.awaiting_assistant? %>
         <span class="chip agent-chip thinking-chip">🪶 <span class="typing-dots mini"><span></span><span></span><span></span></span></span>
       <% elsif card.discussing? && card.events.conversation.last&.actor == "assistant" %>
         <span class="chip agent-chip">🪶 replied</span>
       <% end %>
-      <% if (card.running? || card.needs_attention?) && (last_run = card.runs.order(:id).last) && (last_run.cost.to_f.positive? || last_run.output_tokens.positive?) %>
-        <span class="chip">$<%= last_run.cost.round(2) %><%= " · #{(last_run.output_tokens / 1000.0).round(1)}k out" if card.working? %></span>
-      <% 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.present? && card.pr_url.blank? %><span class="chip branch">🌿 <%= card.branch_name.delete_prefix("cardinal/") %></span><% end %>
     </div>
   <% end %>
-  <% 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>
-    </a>
+  <% has_cost = card.total_cost.positive? || card.total_output_tokens.positive? %>
+  <% if has_cost || card.pr_url.present? %>
+    <div class="card-footer">
+      <% if card.pr_url.present? %>
+        <a class="footer-pr" href="<%= card.pr_url %>" target="_blank" rel="noopener" title="Open the pull request on GitHub">GitHub #<%= card.pr_url[%r{/pull/(\d+)}, 1] %> ↗</a>
+      <% else %>
+        <span class="footer-pr"></span>
+      <% end %>
+      <span class="footer-center"><%= "🤖 #{card.column.model_label}" if has_cost && card.column.model_label %></span>
+      <span class="footer-cost"><%= "$#{card.total_cost.round(2)}" if has_cost %></span>
+    </div>
   <% end %>
 </article>

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

@@ -0,0 +1,28 @@
+<div id="card_compact" class="summary-panel compact-panel" data-controller="autosave">
+  <div class="summary-head">
+    <h3>Technical compact <span class="autosave-status" data-autosave-target="status"></span></h3>
+    <% if card.compact_working? %>
+      <button type="button" class="deep-dive working summary-generate" disabled>
+        <span class="pulse-dot"></span> Generating…
+      </button>
+    <% else %>
+      <%= button_to compact_card_path(card), class: "deep-dive summary-generate",
+            title: "Distill everything this card did into a dense technical journal a resuming agent can read" do %>
+        ✨ <%= card.compact.present? ? "Regenerate" : "Generate compact" %>
+      <% end %>
+    <% end %>
+  </div>
+
+  <p class="hint summary-blurb">A dense, technical journal of what was built, decided, and blocked — the AI reads this to resume work without re-exploring the repo. Fully editable; your edits are respected when you regenerate.</p>
+
+  <%= form_with model: card, class: "summary-form",
+        data: { autosave_target: "form", action: "input->autosave#save change->autosave#save" } do |f| %>
+    <%= hidden_field_tag :autosave, "1" %>
+    <%= f.text_area :compact, rows: 10, placeholder: "No compact yet — click Generate compact, or write your own technical notes.",
+          disabled: card.compact_working? %>
+  <% end %>
+
+  <% if card.compact_generated_at.present? %>
+    <p class="hint summary-stamp">Last generated <%= time_ago_in_words(card.compact_generated_at) %> ago</p>
+  <% end %>
+</div>

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

@@ -31,12 +31,21 @@
       <div class="detail-panes">
         <section class="timeline" data-controller="scroll">
           <nav class="zoom-tabs">
-            <% %w[conversation activity debug].each do |zoom| %>
+            <% %w[conversation activity debug summary compact].each do |zoom| %>
               <%= link_to zoom.capitalize, card_path(@card, zoom: zoom),
                           class: ("active" if @zoom == zoom) %>
             <% end %>
           </nav>
 
+          <% if @zoom == "summary" %>
+            <div class="timeline-scroll">
+              <%= render "cards/summary_panel", card: @card %>
+            </div>
+          <% elsif @zoom == "compact" %>
+            <div class="timeline-scroll">
+              <%= render "cards/compact_panel", card: @card %>
+            </div>
+          <% else %>
           <div class="timeline-scroll" data-scroll-target="scroller">
             <% if @card.description.present? %>
               <div class="event event-description"><%= render_markdown @card.description %></div>
@@ -65,6 +74,7 @@
                   data: { controller: "composer", action: "keydown->composer#keydown" },
                   placeholder: (@card.column.planning? ? "Discuss this card with the planning assistant…" : "Add a note to this card…") + " (Enter sends, Shift+Enter for a new line)" %>
           <% end %>
+          <% end %>
         </section>
 
         <aside class="work-panel">
@@ -117,7 +127,7 @@
               <%= link_to "View Pull Request", @card.pr_url, target: "_blank", rel: "noopener", class: "pr-view-btn" %>
             <% end %>
             <% if @card.in_review? %>
-              <div class="panel-callout callout-plan">
+              <div class="panel-callout callout-plan" id="review-callout">
                 <p><strong>Your verdict.</strong> Check the final report in the timeline.
                 Approve, or just say what's wrong in the conversation — that marks it changes-requested,
                 and dragging the card back to a work column carries your feedback into the next run.</p>
@@ -135,7 +145,7 @@
           <% parked = runs.select(&:needs_input?).last %>
           <% latest = runs.last %>
           <% if parked&.phase == "plan" %>
-            <div class="panel-callout callout-plan">
+            <div class="panel-callout callout-plan" id="plan-callout">
               <p><strong>Plan proposed.</strong> Approve to let the agent execute, or reply in the timeline to redirect.</p>
               <%= button_to "👍 Approve plan", approve_run_path(parked), class: "approve-btn", form_class: "align-right" %>
             </div>
@@ -175,6 +185,13 @@
             <p class="empty">No runs yet — drag the card into an execution column to assign an agent.</p>
           <% end %>
 
+          <% if latest && (latest.cost.positive? || latest.output_tokens.positive?) %>
+            <div class="work-footer">
+              <span class="footer-left"><%= "🤖 #{@card.column.model_label}" if @card.column.model_label %></span>
+              <span class="footer-cost">$<%= latest.cost.round(2) %> · <%= latest.output_tokens %> out</span>
+            </div>
+          <% end %>
+
           <details class="advanced-rules panel-advanced">
             <summary>Advanced</summary>
             <p class="hint">Deleting removes the card and its entire history (events, runs, workspace). The remote branch and PR, if any, are left untouched.</p>

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

@@ -0,0 +1,5 @@
+<%# Momentary confirmation shown in place of an approval callout, then it
+    auto-closes the card modal (see dismiss_controller). %>
+<div class="panel-callout callout-plan" data-controller="dismiss" data-dismiss-delay-value="1100">
+  <p><strong><%= message %></strong></p>
+</div>

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

@@ -0,0 +1,28 @@
+<div id="card_summary" class="summary-panel" data-controller="autosave">
+  <div class="summary-head">
+    <h3>Customer summary <span class="autosave-status" data-autosave-target="status"></span></h3>
+    <% if card.summary_working? %>
+      <button type="button" class="deep-dive working summary-generate" disabled>
+        <span class="pulse-dot"></span> Generating…
+      </button>
+    <% else %>
+      <%= button_to summarize_card_path(card), class: "deep-dive summary-generate",
+            title: "Compress everything this card did into a couple of non-technical lines" do %>
+        ✨ <%= card.summary.present? ? "Regenerate" : "Generate summary" %>
+      <% end %>
+    <% end %>
+  </div>
+
+  <p class="hint summary-blurb">A plain-language recap of what this card delivered — ready to drop into a customer chat. Fully editable; your edits are respected when you regenerate.</p>
+
+  <%= form_with model: card, class: "summary-form",
+        data: { autosave_target: "form", action: "input->autosave#save change->autosave#save" } do |f| %>
+    <%= hidden_field_tag :autosave, "1" %>
+    <%= f.text_area :summary, rows: 10, placeholder: "No summary yet — click Generate summary, or write your own.",
+          disabled: card.summary_working? %>
+  <% end %>
+
+  <% if card.summary_generated_at.present? %>
+    <p class="hint summary-stamp">Last generated <%= time_ago_in_words(card.summary_generated_at) %> ago</p>
+  <% end %>
+</div>

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

@@ -134,7 +134,7 @@
           </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>
+          <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, model (this column's active AI model), or blank for a static label. Example: \"Model: | model\".") %></label>
           <%= f.text_area :footer_text, rows: 3, class: "mono",
                 value: footer_config_text(@column),
                 placeholder: "Total cost: | sum_cost" %>

data/config/routes.rb

@@ -10,6 +10,8 @@ Rails.application.routes.draw do
     member do
       patch :move
       post :approve
+      post :summarize
+      post :compact
     end
     resources :messages, only: [:create]
   end

data/db/migrate/20260704130000_add_summary_to_cards.rb

@@ -0,0 +1,7 @@
+class AddSummaryToCards < ActiveRecord::Migration[8.1]
+  def change
+    add_column :cards, :summary, :text
+    add_column :cards, :summary_generated_at, :datetime
+    add_column :cards, :summary_status, :string
+  end
+end

data/db/migrate/20260704140000_add_compact_to_cards.rb

@@ -0,0 +1,7 @@
+class AddCompactToCards < ActiveRecord::Migration[8.1]
+  def change
+    add_column :cards, :compact, :text
+    add_column :cards, :compact_generated_at, :datetime
+    add_column :cards, :compact_status, :string
+  end
+end

data/lib/cardinal/version.rb

@@ -1,3 +1,3 @@
 module Cardinal
-  VERSION = "0.2.6"
+  VERSION = "0.2.8"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cardinal-ai
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.8
 platform: ruby
 authors:
 - Jason Ellis
@@ -175,6 +175,7 @@ files:
 - app/javascript/controllers/board_column_controller.js
 - app/javascript/controllers/clipboard_controller.js
 - app/javascript/controllers/composer_controller.js
+- app/javascript/controllers/dismiss_controller.js
 - app/javascript/controllers/index.js
 - app/javascript/controllers/modal_controller.js
 - app/javascript/controllers/reveal_controller.js
@@ -185,11 +186,13 @@ files:
 - app/jobs/ai_task_job.rb
 - app/jobs/application_job.rb
 - app/jobs/assistant_reply_job.rb
+- app/jobs/compact_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
 - app/jobs/start_run_job.rb
+- app/jobs/summary_job.rb
 - app/mailers/application_mailer.rb
 - app/models/agent_session.rb
 - app/models/application_record.rb
@@ -210,7 +213,10 @@ files:
 - app/views/boards/edit.html.erb
 - app/views/boards/show.html.erb
 - app/views/cards/_card.html.erb
+- app/views/cards/_compact_panel.html.erb
 - app/views/cards/_detail.html.erb
+- app/views/cards/_dismiss_flash.html.erb
+- app/views/cards/_summary_panel.html.erb
 - app/views/cards/_tag_picker.html.erb
 - app/views/cards/new.html.erb
 - app/views/cards/show.html.erb
@@ -231,7 +237,6 @@ files:
 - config/bundler-audit.yml
 - config/cable.yml
 - config/ci.rb
-- config/credentials.yml.enc
 - config/database.yml
 - config/environment.rb
 - config/environments/development.rb
@@ -257,6 +262,8 @@ files:
 - 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/migrate/20260704130000_add_summary_to_cards.rb
+- db/migrate/20260704140000_add_compact_to_cards.rb
 - db/queue_schema.rb
 - db/seeds.rb
 - docker/agent/Dockerfile

data/config/credentials.yml.enc

@@ -1 +0,0 @@
-gRbdqLwcuHenzfNXCmiHivELrqct/iaMFWc11UxhtcwPIAyQYYOpoUGziW347shIgbHjK4zVpJQ/la/Te51SO6G1NgGZyJZrFRKB8kebFYcqktQzMRTGRl0ykjWf3y0iN6YPcYC6C/0M3Zr7hasRYG8hX9MOnLFjYUYQw/yZRpM/RR2XBslITX1FubnB/CZrzQzz9WDSYG+TOmR5IUBdn28ZrQxSz8u3oXzuhwibUGf2GNffWM4nHpDmHAiwDq7o8yMrZHipJiiUmo3ffe7YbLR+RdTy3AmIatai8wCEruPvzopfV3hn8b5alhk6g8wZQMW29rV5zwKJhnfIJ/IH8LJJWtudfckYkhh4KDam6TppBdqc8rXWCqodYIt2voYM/ARkQt+CTgVZQCLjlvW2Qm4NTzQCcZZkMllQ7vvpsyZ/vzpaRyYSHIl/9Hzip/orWM7g/SNIm44mDLC8+6IoiVVDSomOaQVEEfRKO7Rny3KahfXpqEiUSfmf--B7qWHwiaPzgA3yLD--x/FY/DNjNt+OyLs4ca9tQQ==