Skip to content

feat: add export_report tool for markdown session reports#212

Open
TerminalGravity wants to merge 5 commits intomainfrom
feat/export-report
Open

feat: add export_report tool for markdown session reports#212
TerminalGravity wants to merge 5 commits intomainfrom
feat/export-report

Conversation

@TerminalGravity
Copy link
Collaborator

@TerminalGravity TerminalGravity commented Mar 11, 2026

Closes #5

Adds a new export_report MCP tool that generates markdown session reports from timeline data.

Features:

  • Activity summary (prompts, tool calls, commits, corrections, errors)
  • Quality indicators (correction rate, error rate, tool density, prompts/commit)
  • Daily breakdown table
  • Most used tools ranking
  • Text-based activity sparkline
  • Relative date support (1week, 30days, etc.)
  • Optional save to ~/.preflight/reports/

All 48 tests pass. Build clean.

Copy link
Collaborator Author

@TerminalGravity TerminalGravity left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clean implementation for #5. The format tiers (summary/daily/detailed) make sense — users can start with the overview and drill in.

The quality indicators (correction rate, error rate, tool calls per prompt) are a nice touch — those are genuinely useful for understanding session effectiveness, not just volume.

Saving to ~/.preflight/reports/ is fine for personal use. Down the road we might want a project-relative option too, but that's not blocking. LGTM.

@TerminalGravity TerminalGravity force-pushed the feat/export-report branch 3 times, most recently from 3549486 to 5f65abf Compare March 16, 2026 18:46
@TerminalGravity TerminalGravity changed the title feat: add export_report tool for markdown session reports feat: add export_report tool for timeline session reports Mar 16, 2026
@TerminalGravity TerminalGravity force-pushed the feat/export-report branch 3 times, most recently from 1fefc76 to f62d0a7 Compare March 18, 2026 14:46
@TerminalGravity TerminalGravity changed the title feat: add export_report tool for timeline session reports feat: add export_report tool for timeline reports Mar 18, 2026
@TerminalGravity TerminalGravity force-pushed the feat/export-report branch 2 times, most recently from 6ffbd38 to a7b3f9c Compare March 18, 2026 18:16
Adds a ready-to-use CLAUDE.md template that makes Claude Code
automatically run preflight_check on prompts. Users can copy it
into their project to get preflight working without manual tool calls.

Referenced from Quick Start in README and examples/README.
@TerminalGravity TerminalGravity changed the title feat: add export_report tool for timeline reports feat: add export_report tool for markdown session reports Mar 18, 2026
@TerminalGravity TerminalGravity force-pushed the feat/export-report branch 2 times, most recently from b054ee1 to f321cac Compare March 19, 2026 14:47
- CLI now responds to --help/-h with usage info, profiles, and links
- CLI now responds to --version/-v with package version
- Previously, any flag just launched the interactive wizard
- Fixed README badge from Node 18+ to Node 20+ (matches engines field)
Adds well-commented example config.yml and triage.yml to examples/.preflight/
so users can copy them into their project root and customize. Every field is
documented inline with descriptions of valid values and defaults.
Adds a new export_report MCP tool that generates structured markdown
reports from timeline data. Supports three formats:

- weekly: summary stats, daily breakdown table, key commits, errors
- detailed: full chronological timeline with all events
- digest: compact activity overview with quality indicators

Includes relative date parsing (7days, 2weeks, 1month), optional
file output via save_to parameter, and correction rate / prompt
quality trend metrics.

Closes #5
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.

Export timeline to markdown/PDF reports

1 participant