Skip to content

Report layout: overview first, headline figures, How it's measured, session intent and phase - #12

Open
Expecho wants to merge 4 commits into
mainfrom
report-layout
Open

Expecho wants to merge 4 commits into
mainfrom
report-layout

Conversation

@Expecho

@Expecho Expecho commented Nov 5, 2026

Copy link
Copy Markdown
Owner

Reworks the report layout, mostly for HTML pages.

Layout

  • Overview first: skills, plugins, usage limits and the -a / -r sections come first. The period table (Usage per session, per day, ...) moves to the bottom in table, Markdown and HTML output. CSV keeps it first.
  • Covered period: every report names the period its data covers (first to last activity within the filters). JSON has it as coverage.
  • Headline figures: sessions, prompts, tool calls, PRs, tokens and estimated cost appear under the title. HTML shows them as tiles; Markdown and table output as one line.
  • HTML only:
    • A row of links to every section.
    • Sections keep to the window width, and only a table wider than its section scrolls sideways. Before, every section stretched to the per-session table's width, so most tables were cut off.
    • A How it's measured section, collapsed by default, above the period table. It covers the data read, the period and time zone, and how sessions, tokens, cost, tools, usage limits, adoption phases, intent and recommendations are counted, only for what the report contains.

Session report

  • New columns: Tool (Claude Code, GitHub Copilot or Cursor; with --source all), Intent, Phase and Prompts. JSON rows always have tool.
  • HTML and Markdown list the newest session first. --order overrides this.

Condensed (HTML)

  • The period report's Skills table shows the top 15 rows with a Show all button. The fold is kept after sorting.
  • Recommendations with low impact or under $1 at stake fold under a "more" toggle.
  • Adoption cohort cards lead with the share of sessions instead of PRs per session.
  • Phase mix per week is one stacked bar per week with a legend. Weeks with fewer than 3 sessions are dimmed.

Testing

  • 77 tests pass, 7 of them new.
  • Reports checked in headless Edge screenshots at 1440 px. Summary, terminal and CSV output were also smoke-tested.

🤖 Generated with Claude Code

Expecho and others added 4 commits November 4, 2026 16:49
Documents (table, Markdown, HTML) show the overview sections first and the per-session / per-day table at the bottom; CSV keeps it first. Every report names the period its data covers (first to last activity within the filters; coverage in JSON). HTML reports add a How it's measured section describing the data read and how each figure is counted, limited to what the report contains.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
With --source all the session report gets a Tool column (Claude Code, GitHub Copilot or Cursor, from the session's entrypoint); JSON rows always carry it as tool.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
HTML: the Skills table of period reports shows its top 15 rows with a Show all button (kept after sorting); recommendations with low impact or under $1 at stake fold under a 'more' toggle; How it's measured starts collapsed. Adoption cohort cards lead with the share of sessions instead of PRs per session.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…mix; intent and phase per session

- Sections keep to the window width; only a table wider than its section scrolls.
- Headline figures (sessions, prompts, tool calls, PRs, tokens, cost) under the title, as tiles in HTML and a line in Markdown and table output.
- HTML: a row of links to every section.
- Phase mix per week: the phase shares as one stacked bar with a legend; weeks with fewer than 3 sessions dimmed.
- Session report: Intent, Phase and Prompts per session; HTML and Markdown list the newest session first unless --order is given.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant