cardinal-ai 0.2.13 → 0.2.16

data/app/models/column.rb

@@ -134,11 +134,12 @@ class Column < ApplicationRecord
   def footer_value(compute)
     case compute.to_s
     when "sum_cost"
-      "$%.2f" % column_runs.sum(:cost)
+      "$%.2f" % (column_runs.sum(:cost) + column_ai_calls.sum(:cost))
     when "sum_tokens"
-      ActiveSupport::NumberHelper.number_to_delimited(column_runs.sum("input_tokens + output_tokens"))
+      ActiveSupport::NumberHelper.number_to_delimited(
+        column_runs.sum("input_tokens + output_tokens") + column_ai_calls.sum("input_tokens + output_tokens"))
     when "count_cards"
-      cards.count.to_s
+      cards.active.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.
@@ -194,6 +195,11 @@ class Column < ApplicationRecord
 
   # 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 })
+    Run.joins(agent_session: :card).where(cards: { column_id: id }).where.not(cards: { status: "archived" })
+  end
+
+  # One-shot AI spend (assistant/ai_task/summary/…) of this column's cards.
+  def column_ai_calls
+    AiCall.where(card_id: cards.active.select(:id))
   end
 end

data/app/services/agent/runner.rb

@@ -74,8 +74,12 @@ module Agent
       begin_segment!
       if run.phase == "plan" && approve
         run.update!(phase: "execute")
-        stream_agent(prompt: "Your plan is approved — execute it now.\n\n#{execute_rules}",
-                     mode: "execute", resuming: true)
+        # Approve-with-notes: an approval may carry final adjustments — fold
+        # them into the execute prompt instead of silently dropping them.
+        prompt = ["Your plan is approved — execute it now.",
+                  (message.present? ? "Notes from the user to fold in as you execute:\n\n#{message}" : nil),
+                  execute_rules].compact.join("\n\n")
+        stream_agent(prompt: prompt, mode: "execute", resuming: true)
       elsif run.phase == "plan"
         stream_agent(prompt: "Feedback on your plan:\n\n#{message}\n\nRevise the plan accordingly, present it, and stop again for approval. Stay in read-only mode.",
                      mode: "plan", resuming: true)
@@ -263,6 +267,10 @@ module Agent
         ensure_pull_request(workspace)
       end
 
+      if (undelivered = Array(run.briefing["steering"])).any?
+        card.log!("status_change", run: run,
+                  text: "#{undelivered.size} queued note(s) never reached the agent — the run finished before its next check-in. They stay in the conversation, so the next run will see them.")
+      end
       run.update!(status: "succeeded", finished_at: Time.current,
                   result_summary: report.presence&.truncate(2000))
       card.log!("final_report", actor: "agent", run: run,
@@ -331,13 +339,20 @@ module Agent
 
     def base_sha = run.briefing.fetch("base_sha")
 
+    # "Closes #N" makes GitHub close the source issue on merge (card #49).
+    def pr_body
+      [("Closes ##{card.issue_number}" if card.issue_number.present?),
+       "Automated work by Cardinal card ##{card.number}'s agent.",
+       card.description].compact.join("\n\n")
+    end
+
     def ensure_pull_request(workspace)
       return if card.pr_url.present?
       out, status = Open3.capture2e(
         "gh", "pr", "create", "--draft",
         "--head", card.branch_name,
         "--title", "##{card.number} #{card.title}",
-        "--body", "Automated work by Cardinal card ##{card.number}'s agent.\n\n#{card.description}",
+        "--body", pr_body,
         chdir: workspace.path.to_s
       )
       if status.success? && (url = out[%r{https://github\.com/\S+/pull/\d+}])

data/app/services/claude_cli.rb

@@ -34,11 +34,15 @@ module ClaudeCli
   # resume: continue an existing claude session (context carries over).
   # with_session: return [text, session_id] instead of just text, so callers
   # can keep a continuing conversation (the planning assistant does).
+  # ledger: { kind:, card: } — record this call's tokens/cost as an AiCall
+  # (§ money honesty: planning conversations and maintenance calls spend real
+  # dollars; only worker runs used to be counted).
   def self.prompt(text, system: nil, model: nil, tools: nil, cwd: nil, max_turns: 1,
-                  resume: nil, with_session: false)
+                  resume: nil, with_session: false, ledger: nil)
     raise Error.new("claude CLI not found on PATH") unless available?
 
     json = invoke(text, system:, model:, tools:, cwd:, max_turns:, resume:)
+    record_usage!(json, ledger, model)
     if success?(json)
       return with_session ? [json["result"].to_s, json["session_id"]] : json["result"].to_s
     end
@@ -47,6 +51,7 @@ module ClaudeCli
     # force an answer from the context it already gathered.
     if json["subtype"] == "error_max_turns" && json["session_id"].present?
       wrapped = invoke(WRAP_UP, model:, cwd:, tools: "", max_turns: 2, resume: json["session_id"])
+      record_usage!(wrapped, ledger, model)
       if success?(wrapped)
         return with_session ? [wrapped["result"].to_s, wrapped["session_id"] || json["session_id"]] : wrapped["result"].to_s
       end
@@ -57,6 +62,23 @@ module ClaudeCli
     raise Error.new(friendly_failure(json), detail: json.to_json)
   end
 
+  # Best-effort by design: a ledger failure must never break the AI call that
+  # already succeeded. Failed calls are recorded too — they cost money.
+  def self.record_usage!(json, ledger, model)
+    return unless ledger.is_a?(Hash) && ledger[:kind].present?
+    usage = json["usage"] || {}
+    AiCall.create!(
+      card: ledger[:card],
+      kind: ledger[:kind].to_s,
+      model: json["model"] || model,
+      input_tokens: usage["input_tokens"].to_i,
+      output_tokens: usage["output_tokens"].to_i,
+      cost: json["total_cost_usd"].to_f
+    )
+  rescue StandardError => e
+    Rails.logger.warn("AiCall ledger write failed: #{e.class}: #{e.message}")
+  end
+
   def self.success?(json)
     json["subtype"] == "success" && !json["is_error"]
   end

data/app/services/github_issues.rb

@@ -0,0 +1,49 @@
+# GitHub Issues sync (card #49): issues are the adjacent primitive to cards —
+# gh is already authenticated, so import is a listing + a click, and closing
+# happens naturally via "Closes #N" in the card's PR body.
+module GithubIssues
+  Issue = Struct.new(:number, :title, :body, :labels, keyword_init: true)
+
+  def self.available?(board)
+    board.repo_url.present? && board.local_path.present?
+  end
+
+  # Open issues, newest first. Empty array on any failure (no remote, gh not
+  # authed, offline) — the modal explains instead of erroring.
+  def self.list(board)
+    out, status = Open3.capture2e(
+      "gh", "issue", "list", "--state", "open", "--limit", "50",
+      "--json", "number,title,body,labels", chdir: board.local_path
+    )
+    return [] unless status.success?
+    JSON.parse(out).map do |i|
+      Issue.new(number: i["number"], title: i["title"], body: i["body"].to_s,
+                labels: Array(i["labels"]).map { |l| l["name"] })
+    end
+  rescue JSON::ParserError
+    []
+  end
+
+  # One click → one card in the inbox, tagged with the issue's labels, body
+  # carried as the description with provenance. Best-effort backlink comment
+  # on the issue so the GitHub side knows where the work went.
+  def self.import!(board, number)
+    issue = list(board).find { |i| i.number == number.to_i }
+    raise ArgumentError, "issue ##{number} not found among open issues" unless issue
+
+    existing = board.cards.find_by(issue_number: issue.number)
+    return existing if existing
+
+    inbox = board.columns.inbox.order(:position).first
+    card = board.cards.create!(
+      column: inbox, title: issue.title, issue_number: issue.number,
+      tags: issue.labels.first(5),
+      description: "#{issue.body.presence || "(no issue body)"}\n\n---\n_Imported from GitHub issue ##{issue.number}._"
+    )
+    card.log!("status_change", actor: "user", text: "Imported from GitHub issue ##{issue.number}")
+    Open3.capture2e("gh", "issue", "comment", issue.number.to_s,
+                    "--body", "Tracking in Cardinal as card ##{card.number}. The pull request, when opened, will link back and close this issue on merge.",
+                    chdir: board.local_path)
+    card
+  end
+end

data/app/services/rules/compiler.rb

@@ -22,6 +22,7 @@ module Rules
 
       raw = ClaudeCli.prompt(
         text,
+        ledger: { kind: "rules_compile" },
         model: AssistantReplyJob::FALLBACK_MODEL,
         system: <<~SYS
           You compile plain-English descriptions of Kanban column automation into JSON rule

data/app/services/run_sweeper.rb

@@ -14,8 +14,7 @@ module RunSweeper
   def self.fail_dead_runs
     Run.where(status: %w[queued running]).find_each do |run|
       next if alive?(run)
-      next if run.heartbeat_at && run.heartbeat_at > HEARTBEAT_GRACE.ago
-      next if run.heartbeat_at.nil? && run.created_at > HEARTBEAT_GRACE.ago
+      next if recently_active?(run)
 
       run.update!(status: "failed", finished_at: Time.current,
                   result_summary: "Runner died without finishing (swept)")
@@ -32,7 +31,11 @@ module RunSweeper
   def self.repair_stuck_cards
     Card.where(status: "working").find_each do |card|
       next unless card.column.ai? # non-AI columns: "working" means a human is
-      next if card.runs.where(status: %w[queued running needs_input]).any? { |r| r.needs_input? || alive?(r) }
+      # Same grace as fail_dead_runs: a freshly started run has no pid until
+      # AFTER workspace provisioning (clone/fetch) — recency is its proof of
+      # life, or every just-dragged card risks a bogus "stuck" verdict.
+      next if card.runs.where(status: %w[queued running needs_input])
+                  .any? { |r| r.needs_input? || alive?(r) || recently_active?(r) }
       card.update!(status: "failed")
       card.log!("error", text: "Card was stuck working with no live run; marked failed.")
     end
@@ -42,6 +45,12 @@ module RunSweeper
     Column.where(archetype: "execution").find_each(&:kick_queue)
   end
 
+  # Between state writes (provisioning, spawn) a live run has no pid yet —
+  # a recent heartbeat or recent birth counts as alive.
+  def self.recently_active?(run)
+    (run.heartbeat_at || run.created_at) > HEARTBEAT_GRACE.ago
+  end
+
   def self.alive?(run)
     pid = run.agent_session&.config&.dig("pid")
     return false if pid.blank?

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

@@ -0,0 +1,56 @@
+<header class="topbar">
+  <div class="topbar-left">
+    <h1><%= link_to "Cardinal AI", root_path %> <span class="sep">▸</span> <%= @board.name %> <span class="sep">▸</span> Archive</h1>
+  </div>
+  <div class="topbar-right">
+    <%= link_to "← Back to board", root_path, class: "theme-toggle" %>
+  </div>
+</header>
+
+<main class="archive-page" data-controller="filter">
+  <div class="archive-tools">
+    <input type="search" class="global-search" placeholder="Search the archive…  /"
+           data-filter-target="global"
+           data-action="input->filter#global keydown->filter#clear">
+    <span class="hint"><%= pluralize(@cards.size, "archived card") %></span>
+  </div>
+
+  <div class="archive-rails" data-controller="autosave">
+    <%= form_with url: board_path(autosave: 1), method: :patch,
+          data: { autosave_target: "form" } do %>
+      <%= hidden_field_tag "board[archive_accepts_from][]", "" %>
+      <span class="rails-label">Drag-to-archive from:
+        <span class="autosave-status" data-autosave-target="status"></span></span>
+      <% @board.columns.each do |column| %>
+        <label class="check-row inline-check">
+          <%= check_box_tag "board[archive_accepts_from][]", column.id,
+                @board.archive_accepts?(column), data: { action: "change->autosave#save" } %>
+          <%= column.name %>
+        </label>
+      <% end %>
+      <span class="hint">Checked columns can drop cards straight onto the 🗄 button on the board. Explicit only — nothing checked means no drag target. The card's own Archive button always works.</span>
+    <% end %>
+  </div>
+
+  <% if @cards.any? %>
+    <ul class="archive-list">
+      <% @cards.each do |card| %>
+        <li class="card archive-row" data-search="<%= [card.title, "##{card.number}", Array(card.tags).join(" "), card.description.to_s.truncate(400)].join(" ").downcase %>">
+          <div class="archive-main">
+            <span class="archive-title">#<%= card.number %> <%= card.title %></span>
+            <span class="archive-meta">
+              <% card.tags.each do |tag| %><span class="tag"><%= tag %></span><% end %>
+              from <%= card.column.name %> · archived <%= card.updated_at.strftime("%b %-d") %>
+              <% if card.total_cost.positive? %> · $<%= card.total_cost.round(2) %><% end %>
+              <% if card.pr_url.present? %> · <a href="<%= card.pr_url %>" target="_blank" rel="noopener">PR ↗</a><% end %>
+            </span>
+          </div>
+          <%= button_to "↩ Restore", unarchive_card_path(card), class: "theme-toggle restore-btn",
+                title: "Back to #{card.column.name}" %>
+        </li>
+      <% end %>
+    </ul>
+  <% else %>
+    <p class="empty">Nothing archived yet. Cards can be archived from their detail view (Advanced) once they're done.</p>
+  <% end %>
+</main>

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

@@ -18,6 +18,8 @@
             Generated <%= @board.brief_generated_at&.strftime("%b %-d, %H:%M") %>
             from <code><%= @board.brief_sha&.first(7) %></code>
             with <%= @board.brief_model %>
+            <% dive_cost = AiCall.where(kind: "deep_dive").order(:id).last&.cost.to_f %>
+            <% if dive_cost.positive? %> for $<%= sprintf("%.2f", dive_cost) %><% end %>
             <% behind = @board.commits_behind_brief %>
             <% if behind&.positive? %>
               · <span class="brief-behind"><%= pluralize(behind, "commit") %> behind HEAD</span>

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

@@ -0,0 +1,41 @@
+<%= turbo_frame_tag "modal", data: { turbo_permanent: true } do %>
+  <div class="modal-backdrop" data-controller="modal" data-action="click->modal#backdrop">
+    <div class="modal modal-sm">
+      <header class="modal-header">
+        <h1>⬇ GitHub Issues</h1>
+        <button type="button" class="modal-close" data-action="modal#close" title="Close (Esc)">✕</button>
+      </header>
+      <div class="modal-body">
+        <p class="hint">
+          Open issues on <code><%= @board.repo_url.presence || "(no remote)" %></code>. Importing
+          creates a Tasks card carrying the issue body and labels; the card's pull request will
+          say <code>Closes #N</code>, so merging through Done closes the issue on GitHub.
+        </p>
+
+        <% if @issues.any? %>
+          <ul class="issue-list">
+            <% @issues.each do |issue| %>
+              <li class="issue-row">
+                <div>
+                  <strong>#<%= issue.number %></strong> <%= issue.title %>
+                  <% issue.labels.first(4).each do |label| %><span class="tag"><%= label %></span><% end %>
+                </div>
+                <% if (card_number = @imported[issue.number]) %>
+                  <%= link_to "card ##{card_number}", card_path(card_number),
+                        class: "hint", data: { turbo_frame: "modal", turbo_action: "advance" } %>
+                <% else %>
+                  <%= button_to "Import", import_issue_board_path(number: issue.number),
+                        form: { data: { turbo_frame: "modal" } } %>
+                <% end %>
+              </li>
+            <% end %>
+          </ul>
+        <% elsif !GithubIssues.available?(@board) %>
+          <p class="empty">This board's repo has no GitHub remote — nothing to sync.</p>
+        <% else %>
+          <p class="empty">No open issues found (or gh isn't authenticated — try <code>gh auth status</code>).</p>
+        <% end %>
+      </div>
+    </div>
+  </div>
+<% end %>

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

@@ -9,6 +9,8 @@
     <%= 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" %>
+    <%= link_to "⬇ Issues", issues_board_path, data: { turbo_frame: "modal" },
+          class: "theme-toggle", title: "Import open GitHub issues as cards" %>
     <%# 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+.
@@ -96,6 +98,12 @@
         </div>
       </details>
     <% end %>
+    <% archived_count = @board.cards.archived.count %>
+    <span class="archive-drop" data-controller="archive-drop"
+          data-accepts="<%= Array(@board.archive_accepts_from).join(",") %>">
+      <%= link_to "🗄#{" #{archived_count}" if archived_count.positive?}", archive_board_path,
+            class: "theme-toggle archive-link", title: "Archive — click to browse; drag a card here to archive it (allowed columns are set on the archive page)" %>
+    </span>
     <details class="new-column">
       <summary>+ Column</summary>
       <%= form_with url: columns_path, class: "new-column-form" do |f| %>

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

@@ -1,5 +1,5 @@
 <article class="card status-<%= card.status %>" id="<%= dom_id(card) %>" data-card-id="<%= card.number %>"
-         data-search="<%= [card.title, "##{card.number}", Array(card.tags).join(" "), card.description.to_s.truncate(400)].join(" ").downcase %>">
+         data-search="<%= [card.title, "##{card.number}", Array(card.tags).join(" "), strip_attachment_tokens(card.description).truncate(400)].join(" ").downcase %>">
   <%= link_to card_path(card), class: "card-link", data: { turbo_frame: "modal", turbo_action: "advance" } do %>
     <div class="card-title">
       <%= card.title %>
@@ -23,6 +23,8 @@
       <% card.tags.each do |tag| %><span class="tag"><%= tag %></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.planning_ready? %>
+        <span class="chip agent-chip ready-chip" title="The assistant has posted a Ready-for-execution brief — drag onward when you are">🪶 ready</span>
       <% elsif card.discussing? && card.events.conversation.last&.actor == "assistant" %>
         <span class="chip agent-chip">🪶 replied</span>
       <% end %>

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

@@ -1,6 +1,10 @@
 <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>
+    <div class="summary-head-right">
+    <% if card.compact_generated_at.present? %>
+      <span class="summary-stamp">generated <%= time_ago_in_words(card.compact_generated_at) %> ago</span>
+    <% end %>
     <% if card.compact_working? %>
       <button type="button" class="deep-dive working summary-generate" disabled>
         <span class="pulse-dot"></span> Generating…
@@ -11,6 +15,7 @@
         ✨ <%= card.compact.present? ? "Regenerate" : "Generate compact" %>
       <% end %>
     <% end %>
+    </div>
   </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>
@@ -22,7 +27,4 @@
           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

@@ -35,6 +35,9 @@
               <%= link_to zoom.capitalize, card_path(@card, zoom: zoom),
                           class: ("active" if @zoom == zoom) %>
             <% end %>
+            <% if (spend = @card.assistant_cost).positive? %>
+              <span class="assistant-spend" title="What this card's planning conversation has cost so far (assistant replies — separate from agent runs)">🪶 $<%= sprintf("%.2f", spend) %></span>
+            <% end %>
           </nav>
 
           <% if @zoom == "summary" %>
@@ -48,7 +51,7 @@
           <% else %>
           <div class="timeline-scroll" data-scroll-target="scroller">
             <% if @card.description.present? %>
-              <div class="event event-description"><%= render_markdown @card.description %></div>
+              <div class="event event-description"><%= render_with_attachments @card.description %></div>
             <% end %>
 
             <div id="card_events">
@@ -71,8 +74,11 @@
 
           <%= form_with url: card_messages_path(@card), class: "message-form" do |f| %>
             <%= f.text_area "message[text]", rows: 2, required: true,
-                  data: { controller: "composer", action: "keydown->composer#keydown" },
+                  data: { controller: "composer attach", action: "keydown->composer#keydown paste->attach#paste" },
                   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)" %>
+            <label class="note-toggle" title="Record this message without asking any AI to respond. Future agents (the next column's assistant or worker) still read it as context — perfect for a parting instruction right before you drag the card onward.">
+              <%= f.check_box "message[note]", {}, "1", "0" %> 📝 note only — no AI reply
+            </label>
           <% end %>
           <% end %>
         </section>
@@ -88,7 +94,8 @@
               <label>Tags</label>
               <%= render "cards/tag_picker", board: @card.board, tags: @card.tags %>
               <label>Description</label>
-              <%= f.text_area :description, rows: 6 %>
+              <%= f.text_area :description, rows: 6,
+                    data: { controller: "attach", action: "paste->attach#paste" } %>
               <label>Branch <span class="hint">— optional</span></label>
               <% if @card.branch_name.present? %>
                 <%# Locked once set — by the user here or by the agent on run start. %>
@@ -226,6 +233,11 @@
 
           <details class="advanced-rules panel-advanced">
             <summary>Advanced</summary>
+            <p class="hint">Archiving takes the card off the board but keeps everything — find and restore it under 🗄 Archive in the topbar.</p>
+            <%= button_to "🗄 Archive card", archive_card_path(@card),
+                  class: "cancel-btn",
+                  form: { data: { turbo_frame: "_top", action: "turbo:submit-end->modal#closeOnSuccess" } },
+                  disabled: @card.running? %>
             <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>
             <%= button_to "🗑 Delete card", card_path(@card), method: :delete,
                   class: "cancel-btn delete-card",

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

@@ -1,6 +1,10 @@
 <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>
+    <div class="summary-head-right">
+    <% if card.summary_generated_at.present? %>
+      <span class="summary-stamp">generated <%= time_ago_in_words(card.summary_generated_at) %> ago</span>
+    <% end %>
     <% if card.summary_working? %>
       <button type="button" class="deep-dive working summary-generate" disabled>
         <span class="pulse-dot"></span> Generating…
@@ -11,6 +15,7 @@
         ✨ <%= card.summary.present? ? "Regenerate" : "Generate summary" %>
       <% end %>
     <% end %>
+    </div>
   </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>
@@ -22,7 +27,4 @@
           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/_column.html.erb

@@ -18,6 +18,13 @@
   <input type="search" class="col-search" placeholder="Filter <%= column.name %>…"
          data-col-id="<%= column.id %>"
          data-action="input->filter#column keydown->filter#clear">
+  <% if column.inbox? %>
+    <%# Quick-add (card #42): title, Enter, done — the modal stays for real write-ups. %>
+    <%= form_with url: cards_path, class: "quick-add", data: { turbo_frame: "_top" } do |f| %>
+      <%= f.text_field "card[title]", placeholder: "Quick add — type a title, press Enter",
+            autocomplete: "off", required: true %>
+    <% end %>
+  <% end %>
   <p class="drop-hint">→ <%= column.drag_hint %></p>
   <div class="cards<%= " cards-clickable" if column.inbox? %>"
        data-controller="board-column"
@@ -25,7 +32,7 @@
        <% if column.inbox? %>data-action="click->board-column#newCard"
        data-board-column-new-url-value="<%= new_card_path %>"<% end %>
        data-column-id="<%= column.id %>">
-    <% column.cards.each do |card| %>
+    <% column.cards.active.each do |card| %>
       <%= render "cards/card", card: card %>
     <% end %>
   </div>

data/app/views/events/_event.html.erb

@@ -13,7 +13,8 @@
     <span class="event-actor"><%= { "user" => "👤", "agent" => "🤖", "assistant" => "🪶", "system" => "·" }[event.actor] || event.actor %></span>
     <div class="event-body">
       <% if event.text %>
-        <%= render_markdown event.text %>
+        <% if event.payload["note"] %><span class="note-flag" title="Note only — no AI was asked to reply; future agents read it as context">📝 note</span><% end %>
+        <%= render_with_attachments event.text %>
       <% else %>
         <code class="event-kind"><%= event.kind %></code>
       <% end %>

data/config/routes.rb

@@ -5,11 +5,16 @@ Rails.application.routes.draw do
     post :deep_dive
     post :pull
     get :brief
+    get :archive
+    get :issues
+    post :import_issue
   end
   resources :cards, only: [:new, :create, :show, :update, :destroy] do
     member do
       patch :move
       post :approve
+      post :archive
+      post :unarchive
       post :summarize
       post :compact
     end

data/db/cable_schema.rb

@@ -1,9 +1,21 @@
-ActiveRecord::Schema[7.1].define(version: 1) do
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# This file is the source Rails uses to define your schema when running `bin/rails
+# db:schema:load`. When creating a new database, `bin/rails db:schema:load` tends to
+# be faster and is potentially less error prone than running all of your
+# migrations from scratch. Old migrations may fail to apply correctly if those
+# migrations use external dependencies or application code.
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema[8.1].define(version: 1) do
   create_table "solid_cable_messages", force: :cascade do |t|
     t.binary "channel", limit: 1024, null: false
-    t.binary "payload", limit: 536870912, null: false
-    t.datetime "created_at", null: false
     t.integer "channel_hash", limit: 8, null: false
+    t.datetime "created_at", null: false
+    t.binary "payload", limit: 536870912, null: false
     t.index ["channel"], name: "index_solid_cable_messages_on_channel"
     t.index ["channel_hash"], name: "index_solid_cable_messages_on_channel_hash"
     t.index ["created_at"], name: "index_solid_cable_messages_on_created_at"

data/db/migrate/20260705120000_create_ai_calls.rb

@@ -0,0 +1,17 @@
+# Usage ledger for every one-shot AI call (card #-less deep dives included).
+# Worker runs track their own usage on Run; this covers the ClaudeCli tier:
+# planning assistant, ai_task rules, deep dive, summary/compact, compiler.
+class CreateAiCalls < ActiveRecord::Migration[8.1]
+  def change
+    create_table :ai_calls do |t|
+      t.references :card, foreign_key: true, null: true
+      t.string :kind, null: false
+      t.string :model
+      t.integer :input_tokens, default: 0, null: false
+      t.integer :output_tokens, default: 0, null: false
+      t.decimal :cost, precision: 10, scale: 6, default: 0, null: false
+      t.datetime :created_at, null: false
+    end
+    add_index :ai_calls, :kind
+  end
+end

data/db/migrate/20260705120001_add_issue_number_to_cards.rb

@@ -0,0 +1,5 @@
+class AddIssueNumberToCards < ActiveRecord::Migration[8.1]
+  def change
+    add_column :cards, :issue_number, :integer
+  end
+end

data/db/migrate/20260705193935_add_settings_to_boards.rb

@@ -0,0 +1,6 @@
+# Board-level knobs (first tenant: which columns may drag-to-archive).
+class AddSettingsToBoards < ActiveRecord::Migration[8.1]
+  def change
+    add_column :boards, :settings, :json, default: {}, null: false
+  end
+end