feat: add export_timeline tool for markdown reports (closes #5) - #258
Open
TerminalGravity wants to merge 4 commits into
Open
feat: add export_timeline tool for markdown reports (closes #5)#258TerminalGravity wants to merge 4 commits into
TerminalGravity wants to merge 4 commits into
Conversation
Shows 4 concrete scenarios: vague prompt clarification, multi-step scoping, correction pattern matching, and cross-service awareness. Each example includes the prompt, triage classification, and the actual output users can expect.
The README and examples/README.md referenced examples/.preflight/ but the actual config files didn't exist. Added: - config.yml — profile, related projects, thresholds, embeddings - triage.yml — keyword rules and strictness settings - contracts/api.yml — manual contract definition examples All files are heavily commented so users can copy them into their project root and customize without needing to reference the docs.
Adds a new MCP tool that generates structured markdown reports from timeline data. Supports three formats: - summary: stats and activity breakdown by type - detailed: full daily breakdown with event-level detail - weekly: week-over-week trend visualization Includes optional save_to parameter for writing reports to disk. 6 tests covering all formats and edge cases.
TerminalGravity
commented
Mar 16, 2026
TerminalGravity
left a comment
TerminalGravity
left a comment
Collaborator
Author
There was a problem hiding this comment.
Reviewed — looks good. Three export formats cover the main use cases well, relative date parsing is a nice touch. Minor thought: might want to validate the save_to path to prevent writes outside the project root. Could see a json format being useful for CI integrations later. Tests are solid.
- Add 'json' format option for CI/machine-readable export - Validate save_to resolves within project root (prevents path traversal) - Add 3 new tests: JSON output, field inclusion, path escape rejection
Collaborator
Author
|
Addressed review feedback:
|
TerminalGravity
commented
Mar 16, 2026
TerminalGravity
left a comment
TerminalGravity
left a comment
Collaborator
Author
There was a problem hiding this comment.
Reviewed — this closes #5 nicely. The export tool is well-structured. A few minor notes:
computeStats— ifeventsis empty,firstEvent/lastEventare empty strings andformatSummarySectionwill.slice(0,10)on them, producing ugly output. Maybe short-circuit with 'No events found'.content.slice(0, 200)truncation doesn't add an ellipsis — could confuse on long entries cut mid-word.- The README walkthrough additions are excellent — way more approachable for new users.
None are blockers. Ready to merge.
TerminalGravity
commented
Mar 16, 2026
TerminalGravity
left a comment
TerminalGravity
left a comment
Collaborator
Author
There was a problem hiding this comment.
Nice feature — three report formats cover the main use cases well. Relative date parsing is a good UX touch. Thoughts:
- Worth documenting
save_topath resolution (relative to cwd vs project root?) - Visual bar charts in weekly format are great for terminal output
- 6 tests cover happy paths — timezone edge cases could be a follow-up
Overlapping files with #265 on examples dir — coordinate merge order. LGTM.
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
1 participant
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.
What
New
export_timelineMCP tool that generates structured markdown reports from timeline data.Formats
Features
7days,2weeks, etc.)save_toparameter to write reports to diskTests
6 tests covering all formats, type breakdowns, empty states, and no-project edge case.
Closes #5