McRitchie Studio
Say Hi 👋
Agents Builders
← All Tasks
Sizing

Add key-method and summary

Archived
add-key-method-and-summary

Created

Jul 04, 02:48

Started

Jul 04, 02:48

Completed

Jul 04, 04:58

DevOps handoff

Type

Feature

Shape

ui+db

Worktree Slug

add-key-method-and-summary

Repositories

mcritchie-studio

Release Slug

—

Branch

feat/add-key-method-and-summary

Pull Request

https://github.com/amcritchie/mcritchie-studio/pull/357

Local URL

http://localhost:3005/alex/heartbeat/spans

QA URL

—

Production URL

—

telemetry-surface api-additive migration

Acceptance Criteria

  • Spans and actions persist optional key_method with language
  • Actions persist a goal summary slug
  • Capture hook derives bash command key_method and summary
  • atomic-event CLI stamps span key_method on close
  • Rows render language badge, code, copy button
  • Capture and event APIs accept new fields
  • Agent docs teach key_method and summary usage

Expected Test Plan

  • [unit] key-method concern, capture, open/close, hook derivation
  • [component] event table renders key chip and summary
  • [integration] capture API persists fields, spans page renders
  • [e2e] spans page shows badge, code, copy button

Checks Run

  • [unit] bin/rails test test/models/has_key_method_test.rb + atomic model tests — concern, open/close, capture
  • [unit] test/lib/atomic_capture_hook_test.rb — bash summary/key_method derivation + secret redaction
  • [component] test/views/heartbeat_event_table_test.rb — span + action chips, lang badge, copy clip, summary
  • [integration] api/v1 atomic_actions + atomic_events controller tests — new fields persist end-to-end
  • [e2e] npx playwright test e2e/alex_heartbeat.spec.js:48 — chips + badges + summary on seeded spans
  • [full-suite@74dbc9cc07b1d4f5fd3214fe097a14f735fd3a8c] bin/rails test green
  • [rubocop@74dbc9cc07b1d4f5fd3214fe097a14f735fd3a8c] bin/rubocop clean

Agent Context

Operator sidequest 07-03 (annotated screenshots of /alex/heartbeat/spans): make the atomic-event trail easier to work from. NEW FIELDS — key_method + key_method_lang on BOTH AtomicEvent (span) and AtomicAction (action rows); summary (goal slug, outcome-free) on AtomicAction only (spans already carry reason_slug as their goal). Mock placement: action rows show key_method in the Status/Task column region and summary in the grade-hint (Alex) column, replacing the click-to-grade hint when present (row stays clickable; hint moves to title); span key_method renders as a third narration line. Each key_method renders as a chip: LEFT language badge (bash/ruby/sql/js/code), monospace code, copy button (window.copyText pattern). WRITE PATHS: (1) agent-provided — bin/atomic-event start/next/end gain --key-method [--key-lang]; on next/end it stamps the CLOSING span (the completed unit); API open/close accept the fields; (2) hook-derived — bin/atomic-capture-hook auto-fills bash actions: summary from tool_input.description, key_method from tool_input.command (lang bash); key_method MUST run through the same secret-redaction path as input (audit finding #6 discipline). Lang inference when blank via shared HasKeyMethod concern (ruby/sql/js patterns, bash-ish default, fallback code). API is ADDITIVE — old hooks keep posting fine. Docs: agents index narration section (teach --key-method), atomic-capture-hook.md, task-board-api.md if it lists capture params. Seeds updated so the spans page demos the chips. Scope note: pipeline page column 1 untouched this pass.

Stage Timeline

Who handled each stage, the time it took (measured), and the model / tokens / cost reported (best-effort) — plus who's on it right now. — means the agent didn't report that metric.

Sizing Avi · PO — Dev MEDIUM Actual XL
  1. Created → Designed
    S Snorlax
    Snorlax
    Model
    —
    Duration
    —
    Tokens
    —
    Cost
    —
    Completed Jul 04, 02:48 · 4 days ago
    api
  2. Designed → Building
    S Snorlax
    Snorlax
    Model
    claude-fable-5
    Duration
    under a minute
    Tokens
    989,805
    Cost
    ~$1.24
    Started Jul 04, 02:48
    Completed Jul 04, 02:48 · 4 days ago
    cli
  3. Building → Submitted
    S Snorlax
    Snorlax
    Model
    claude-fable-5
    Duration
    33 minutes
    Tokens
    48,003,686
    Cost
    ~$57.49
    Started Jul 04, 02:48
    Completed Jul 04, 03:21 · 4 days ago
    cli
  4. Submitted → Reviewed Review Activity
    S Shannon
    Shannon primary
    C Carl
    Carl light
    Model
    claude-fable-5
    Duration
    24 minutes
    Tokens
    2,544,665
    Cost
    ~$6.23
    Started Jul 04, 03:21
    Completed Jul 04, 03:45 · 4 days ago
    cli
  5. Reviewed → Assembled
    S Steffon
    Steffon
    Model
    claude-fable-5
    Duration
    under a minute
    Tokens
    107,183
    Cost
    ~$0.14
    Started Jul 04, 03:45
    Completed Jul 04, 03:46 · 4 days ago
  6. Assembled → Shipped
    A Avi
    Avi
    Model
    claude-fable-5
    Duration
    about 1 hour
    Tokens
    —
    Cost
    —
    Started Jul 04, 03:46
    Completed Jul 04, 04:58 · 4 days ago
  7. Shipped → Archived
    —
    Model
    —
    Duration
    about 16 hours
    Tokens
    —
    Cost
    —
    Started Jul 04, 04:58
    Completed Jul 04, 20:46 · 4 days ago

Conversation

QA review feedback, agent handoffs, and follow-up notes for this task.

No task feedback has been recorded yet.

Sealed-bid sizing

Edit →

Alex (PM)

—

Avi (PO)

—

Dev

MEDIUM

Actual

XL