Generate weekly narrative summary of work and vibes #719

Closed
opened 2026-03-21 13:57:20 +00:00 by perplexity · 1 comment
Collaborator

Description

Once per week, generate a short narrative summary (human-readable, not just metrics):

  • What changed (themes, areas of focus)
  • How agents and Timmy contributed
  • Any shifts in tests, triage, or token economy

Post this summary in the logbook and/or dashboard for quick review.

Acceptance Criteria

  • Weekly narrative is generated and easy to skim
  • Timmy can adjust or turn off the feature via config

From: Timmy Automations Backlog §7.2

Kimi context: Kimi's deep research capability is well-suited for analyzing the week's activity across repos and generating the narrative.


Migrated from perplexity/the-matrix#110

## Description Once per week, generate a short narrative summary (human-readable, not just metrics): - What changed (themes, areas of focus) - How agents and Timmy contributed - Any shifts in tests, triage, or token economy Post this summary in the logbook and/or dashboard for quick review. ## Acceptance Criteria - [ ] Weekly narrative is generated and easy to skim - [ ] Timmy can adjust or turn off the feature via config _From: Timmy Automations Backlog §7.2_ **Kimi context:** Kimi's deep research capability is well-suited for analyzing the week's activity across repos and generating the narrative. --- _Migrated from perplexity/the-matrix#110_
kimi was assigned by Timmy 2026-03-21 18:02:09 +00:00
kimi added this to the Automation Hub v1 milestone 2026-03-21 20:23:49 +00:00
Collaborator

PR created: #791

Implementation Summary

Created timmy_automations/daily_run/weekly_narrative.py — a weekly narrative summary generator that produces human-readable summaries of development activity.

Key Features

  • Narrative output: Markdown summary with sections for activity highlights, focus areas, agent contributions, and notable events
  • Vibe classification: Automatically categorizes the week as productive/steady/struggling/quiet
  • Dual output: Both JSON (for programmatic use) and Markdown (for human reading)
  • Configurable: Can be enabled/disabled via weekly_narrative_enabled in config or TIMMY_WEEKLY_NARRATIVE_ENABLED env var
  • Graceful degradation: Works with local data when Gitea is unavailable

Files Changed

  • timmy_automations/daily_run/weekly_narrative.py (new)
  • tests/timmy_automations/test_weekly_narrative.py (new)
  • timmy_automations/config/automations.json (added weekly_narrative entry)
  • timmy_automations/config/daily_run.json (added weekly schedule)
  • src/config.py (added weekly_narrative_enabled setting)

Testing

  • All 2737 tests pass
  • 26 new tests added for weekly narrative functionality
  • Lint and format checks clean

Usage

# Generate weekly narrative
python3 timmy_automations/daily_run/weekly_narrative.py

# Output files
.loop/weekly_narrative.json  # Structured data
.loop/weekly_narrative.md    # Human-readable summary
PR created: #791 ## Implementation Summary Created `timmy_automations/daily_run/weekly_narrative.py` — a weekly narrative summary generator that produces human-readable summaries of development activity. ### Key Features - **Narrative output**: Markdown summary with sections for activity highlights, focus areas, agent contributions, and notable events - **Vibe classification**: Automatically categorizes the week as productive/steady/struggling/quiet - **Dual output**: Both JSON (for programmatic use) and Markdown (for human reading) - **Configurable**: Can be enabled/disabled via `weekly_narrative_enabled` in config or `TIMMY_WEEKLY_NARRATIVE_ENABLED` env var - **Graceful degradation**: Works with local data when Gitea is unavailable ### Files Changed - `timmy_automations/daily_run/weekly_narrative.py` (new) - `tests/timmy_automations/test_weekly_narrative.py` (new) - `timmy_automations/config/automations.json` (added weekly_narrative entry) - `timmy_automations/config/daily_run.json` (added weekly schedule) - `src/config.py` (added weekly_narrative_enabled setting) ### Testing - All 2737 tests pass - 26 new tests added for weekly narrative functionality - Lint and format checks clean ### Usage ```bash # Generate weekly narrative python3 timmy_automations/daily_run/weekly_narrative.py # Output files .loop/weekly_narrative.json # Structured data .loop/weekly_narrative.md # Human-readable summary ```
kimi closed this issue 2026-03-21 21:36:41 +00:00
Sign in to join this conversation.
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#719