feat: entire recap command

[peyton-alt]

https://entire.io/gh/entireio/cli/trails/bd45a590a611

Summary

• Redesigns the entire recap terminal output per spec at docs/2026-04-22-entire-recap-visual-redesign-design.md
• Three-panel layout (summary → activity strip → agents), per-agent cards with comparison bars
• Wires CLI to the new /api/v1/me/recap endpoint (pairs with entirehq/entire.io#1604)
• New TUI v keybinding cycles view mode (me/team/both)
• Drops --30 flag (redundant with --month), drops the worktrees/labels/repos bottom panel

Changes

• Server client — cmd/entire/cli/recap/me_recap.go (new) fetches /api/v1/me/recap; recap.go prefers it with fallback to the old three-endpoint stack.
• Bar primitive — cmd/entire/cli/recap/render_bar.go (new) renders comparison bars with 9 TDD unit tests.
• Summary panel — render_summary.go (new): you / team metric rows + reflowing top line + context line. Empty signals omit instead of placeholder.
• Activity strip — render_activity.go (new): every cell rendered (including zero days), axis anchored to today, most active annotation.
• Agents card — rewritten around three field groups: bars → team qualitative → your qualitative. Empty rows drop entirely.
• View toggle — --view me|contributors|both + TUI v key. Prefixes only in both mode.
• Cleanup — removes Range30d, removes bottom panel, adds JSON tags to LabelCount.

Pairs with

• Server endpoint: entirehq/entire.io#1604 (draft)

Test plan

• 9 renderComparisonBar unit tests (TDD, all pass)
• Summary / activity / agents card renderer tests updated
• mise run check — full CI gate green (90s)
• Live smoke vs. local wrangler dev: renders the spec output with real me + team data

Out of scope / follow-ups

• Rename recap → activity per docs/2026-04-21-entire-activity-replan.md
• Server-side aggregateByAgent unit tests (against entire.io)

🤖 Generated with Claude Code

---

Note

Medium Risk
Adds a new entire recap command that combines local session data with authenticated server endpoints and a new on-disk cache, plus an optional TUI mode; regressions would primarily impact CLI output and network interactions. Risk is moderated by extensive unit tests and best-effort fallbacks when auth/API data is unavailable.

Overview
Introduces a new entire recap command that summarizes recent checkpoint activity with a redesigned 3-panel terminal layout (summary, activity strip, per-agent cards) and optional TUI rendering.

The recap pipeline now loads local session/checkpoint state, links checkpoints to commits via Entire-Checkpoint trailers, and optionally enriches checkpoints from the API (labels/skills/tool profile) using a safe, version-aware disk cache that avoids caching “empty/pending” analyses.

Adds team/contributor comparisons by fetching aggregated data from the new /api/v1/me/recap endpoint (with fallback to legacy repo-overview endpoints + batch analyses), plus new flags for time range, agent filtering, view mode (me|contributors|both), refresh-cache, and allowing insecure HTTP for local dev.

^{Reviewed by Cursor Bugbot for commit 32c0f74. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 3 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 32c0f74. Configure here.}

[Copilot]

Pull request overview

Implements a redesigned entire recap experience (static + TUI) with new visual layout and “me vs team” comparisons, and wires contributor data to the new /api/v1/me/recap endpoint with a fallback to legacy overview endpoints. Also factors relative-time formatting into a shared stringutil.TimeAgo.

Changes:

• Adds new recap command (static renderer + Bubble Tea TUI) with range/agent filtering and v view-mode cycling (me/contributors/both).
• Introduces recap data model, loaders, enrichment/cache, server-client types, and multiple render primitives (panels, summary, activity strip, agent cards, bars).
• Extracts TimeAgo into stringutil and updates existing CLI surfaces to use it.

Reviewed changes

Copilot reviewed 65 out of 65 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
go.mod	Promotes go-isatty to a direct dependency for recap format auto-detection.
cmd/entire/cli/trail_cmd.go	Switches to stringutil.TimeAgo in trail listing output.
cmd/entire/cli/testutil/testutil.go	Adds GitCommitWithMsg helper for commits with bodies/trailers.
cmd/entire/cli/testutil/git_commit_with_msg_test.go	Tests GitCommitWithMsg preserves trailers in commit messages.
cmd/entire/cli/stringutil/time.go	Adds shared TimeAgo formatter.
cmd/entire/cli/stringutil/time_test.go	Unit tests for TimeAgo.
cmd/entire/cli/status_test.go	Removes the old inline timeAgo tests (moved to stringutil).
cmd/entire/cli/status_style.go	Uses stringutil.TimeAgo for “active …” display.
cmd/entire/cli/status.go	Removes local timeAgo and uses stringutil.TimeAgo.
cmd/entire/cli/sessions.go	Uses stringutil.TimeAgo in session rendering.
cmd/entire/cli/search_tui.go	Uses stringutil.TimeAgo in search UI “age” formatting.
cmd/entire/cli/root.go	Registers the new recap command.
cmd/entire/cli/recap.go	Adds the recap Cobra command, format selection, contributor fetching, cache refresh, and TUI runner.
cmd/entire/cli/recap_test.go	Tests flag parsing/registration and format resolution behavior.
cmd/entire/cli/recap/tui.go	Implements Bubble Tea model for interactive recap (range/agent/view toggles).
cmd/entire/cli/recap/tui_test.go	Tests TUI model behavior and keybindings (range/agent/view/quit).
cmd/entire/cli/recap/tool_categorize.go	Adds tool invocation categorization logic for recap metrics.
cmd/entire/cli/recap/tool_categorize_test.go	Tests tool categorization mapping.
cmd/entire/cli/recap/testutil_test.go	Adds heavy test fixtures for isolated git/session/checkpoint metadata setup.
cmd/entire/cli/recap/styles.go	Defines recap lipgloss style palette/roles and plain-mode behavior.
cmd/entire/cli/recap/styles_test.go	Tests style behavior (plain mode no ANSI, text preservation).
cmd/entire/cli/recap/render_summary.go	Implements redesigned summary panel rendering (you/team/top/context).
cmd/entire/cli/recap/render_summary_test.go	Tests summary rendering and “top line” reflow/omission.
cmd/entire/cli/recap/render_static.go	Implements full static recap renderer + session fallback.
cmd/entire/cli/recap/render_static_test.go	Tests static output panels, placeholders, and “no bottom panel” behavior.
cmd/entire/cli/recap/render_panel.go	Adds shared panel wrapper renderer.
cmd/entire/cli/recap/render_panel_test.go	Tests panel wrapper behavior under various widths/titles.
cmd/entire/cli/recap/render_chart.go	Adds heatmap strip, gradient bar, and intra-day strip renderers.
cmd/entire/cli/recap/render_chart_test.go	Tests chart primitives for edge cases and formatting.
cmd/entire/cli/recap/render_bar.go	Adds you/team comparison bar primitive.
cmd/entire/cli/recap/render_bar_test.go	Tests comparison bar behavior across many scenarios.
cmd/entire/cli/recap/render_activity.go	Implements activity strip panel with peak annotation and axis labels.
cmd/entire/cli/recap/render_activity_test.go	Tests activity strip rendering rules (zeros, peak annotation, day peak hour).
cmd/entire/cli/recap/model.go	Defines recap data model projections and enums.
cmd/entire/cli/recap/model_test.go	Tests model helpers like SpanMinutes and DataSource.String().
cmd/entire/cli/recap/model_range_test.go	Compile-time guard that Range30d is removed.
cmd/entire/cli/recap/metrics.go	Adds aggregation helpers (range/day/agent/repo, dominant label).
cmd/entire/cli/recap/metrics_test.go	Tests metrics/aggregation correctness and thresholds.
cmd/entire/cli/recap/me_recap.go	Adds client/types for /api/v1/me/recap and conversion to local shapes.
cmd/entire/cli/recap/load.go	Loads local session/checkpoint data, links commits, stamps repos, enriches via API.
cmd/entire/cli/recap/load_test.go	Tests recap loading defaults and scope/enrichment behaviors.
cmd/entire/cli/recap/load_checkpoints_test.go	Tests checkpoint attachment, dedupe, and linked-commit propagation.
cmd/entire/cli/recap/load_linked.go	Implements linked commit lookup via git log trailer scanning.
cmd/entire/cli/recap/load_linked_test.go	Tests linked commit lookup by trailer.
cmd/entire/cli/recap/insights.go	Adds “next action” hint selection.
cmd/entire/cli/recap/insights_test.go	Tests next-action priority rules.
cmd/entire/cli/recap/heatmap.go	Adds daily heatmap builder + intensity tiers.
cmd/entire/cli/recap/heatmap_test.go	Tests heatmap bucketing and intensity mapping.
cmd/entire/cli/recap/enrich.go	Adds checkpoint analysis enrichment with caching and safety checks.
cmd/entire/cli/recap/enrich_test.go	Tests enrichment behavior, caching, deep-copy, and invalid repo handling.
cmd/entire/cli/recap/cache.go	Adds on-disk analysis cache with key validation and atomic writes.
cmd/entire/cli/recap/cache_test.go	Tests cache behavior (round-trip, versioning, traversal rejection, atomicity).
cmd/entire/cli/recap/api_types.go	Adds API response types + canonical label taxonomy filtering.
cmd/entire/cli/recap/api_types_test.go	Tests JSON unmarshal + canonical label set behavior.
cmd/entire/cli/recap/aggregate.go	Adds tool-profile/worktree aggregations + repo resolution.
cmd/entire/cli/recap/aggregate_test.go	Tests aggregation helpers + repo remote parsing.
cmd/entire/cli/recap/contributors.go	Fetches/merges contributor data (legacy overview stack + batch analyses).
cmd/entire/cli/recap/contributors_test.go	Tests contributor merge/application behavior.
cmd/entire/cli/recap/badges.go	Adds deterministic local badges (active/linked/delegated/resumed).
cmd/entire/cli/recap/badges_test.go	Tests badge computation.
cmd/entire/cli/recap/agents_card.go	Builds/renders agent cards with comparison bars and qualitative blocks.
cmd/entire/cli/recap/agents_card_test.go	Tests agent-card rendering across view modes and widths.

[peyton-alt]

Example: #1113 makes interactive with toggles