Format entire explain generated summary #1078
Merged
Merged
Conversation
Entire-Checkpoint: 36760b92b50f
Entire-Checkpoint: 36fc2763f43f
Entire-Checkpoint: 18c2a872e364
Contributor
There was a problem hiding this comment.
Pull request overview
Updates entire explain to emit a more structured, branded output format (header/table + markdown-rendered summary) and adjusts the test suite to match the new strings.
Changes:
- Reformats explain output header (e.g.,
● Checkpoint <id>) and token/commit metadata presentation. - Renders AI summaries (and verbose/full file lists) as markdown, with terminal rendering when color is enabled.
- Improves pager handling by centralizing pager resolution and conditionally injecting
LESS=-Rforless.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| e2e/tests/explain_test.go | Updates E2E assertions to match the new explain header format. |
| e2e/tests/attach_test.go | Updates E2E assertions for explain output after attach/resume flows. |
| cmd/entire/cli/integration_test/explain_test.go | Updates integration assertions to match the new checkpoint header string. |
| cmd/entire/cli/explain_test.go | Updates/extends unit tests for the new formatting, markdown summary, header rows, and pager env behavior. |
| cmd/entire/cli/explain.go | Implements the new formatted output, markdown summary builder, header rendering, and pager env injection logic. |
| cmd/entire/cli/dispatch_tui.go | Renames markdown style helpers and switches the renderer to use the shared “entire brand” markdown styles. |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
Contributor
Author
|
see example: |
Entire-Checkpoint: deaf19bc66ad
Contributor
Author
|
@BugBot review |
There was a problem hiding this comment.
✅ Bugbot reviewed your changes and found no new issues!
Comment @cursor review or bugbot run to trigger another review on this PR
Reviewed by Cursor Bugbot for commit e008cc7. Configure here.
peyton-alt
changed the title
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> Entire-Checkpoint: e7f82dfb5f49
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> Entire-Checkpoint: 0cca1448b154
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> Entire-Checkpoint: b4f9b076e097
Cover no-summary, temporary, list, session, and failure surfaces with the same identity-bullet + metadata-rows + brand-rendered body shape that PR on the generated summary already uses. Replace "(no prompt)" with a prompt → commit-message → "(no prompt recorded)" cascade. Failures print a styled ✗ block to stderr and return *SilentError so main.go does not double-print. Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> Entire-Checkpoint: 56895e1cb233
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> Entire-Checkpoint: 726145533b1d
Contributor
Author
|
More examples: |
formatSessionInfo has no production caller — entire explain --session flows through formatBranchCheckpoints (the list view), not here. Restyling it for the brand format added ~200 lines of dead-code styling and test churn for a path nobody can reach via the CLI. Restore the original implementation; if a session-detail surface ever ships, revisit. Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]> Entire-Checkpoint: 3769067bdde9
Entire-Checkpoint: 66cd6e56f238
gtrrz-victor
approved these changes
Apr 30, 2026
toothbrush
approved these changes
Apr 30, 2026
Contributor
toothbrush
left a comment
toothbrush
left a comment
There was a problem hiding this comment.
Snazzy colours! I'm not really involved in this but approving to unblock the merge 👍 👍 👍
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
https://entire.io/gh/entireio/cli/trails/265
Summary
entire explaincan render generatedcheckpoint summaries with the same branded terminal markdown treatment as dispatch output.
entire explainbody with structured markdown sections for intent,outcome, learnings, friction, open items, and verbose/full files while preserving plain markdown for
piped and
NO_COLORoutput.associated commits, then tighten the summary spacing so
## Intentstarts directly under the headerrule.
lessreceivesLESS=-Ronly when the user hasnot set
PAGERorLESS.Test Plan
mise run checkmise run test:ciscript -q /tmp/entire-explain-tty.out ./entire explain --checkpoint <checkpointID> --no-pagerNote
Medium Risk
Touches user-facing CLI output formatting and paging behavior; low functional risk but moderate compatibility risk for scripts/tests that parse explain output or rely on previous pager environment defaults.
Overview
Updates
entire explainto emit a compact, styled checkpoint header (session/created/author/tokens/commits) and to render AI checkpoint summaries as structured markdown sections (Intent/Outcome/Learnings/Friction/Open Items, plus Files in verbose/full), using the shared terminal markdown renderer and respectingNO_COLOR/piped output.Refactors transcript display to use section rules and tighter spacing, adjusts output strings across unit/integration/e2e tests and docs, and extracts pager command construction so the default
lesspager getsLESS=-Ronly when the user hasn’t setPAGER/LESS(with new tests around env behavior).Reviewed by Cursor Bugbot for commit e008cc7. Configure here.