[kimi] Weekly narrative summary generator (#719) #791

kimi · 2026-03-21T21:36:16Z

kimi commented

2026-03-21 21:36:16 +00:00

Fixes #719

Summary

This PR implements a weekly narrative summary generator that creates human-readable summaries of development activity.

Changes

New Script

timmy_automations/daily_run/weekly_narrative.py — Main script that:
- Analyzes the past 7 days of development activity
- Extracts themes from issue labels (layers, types)
- Identifies agent contributions and activity patterns
- Calculates test coverage trends and cycle success rates
- Summarizes triage health and token economy shifts
- Classifies the overall "vibe" (productive/steady/struggling/quiet)
- Outputs both JSON (.loop/weekly_narrative.json) and Markdown (.loop/weekly_narrative.md)

Configuration

Added weekly_narrative entry to timmy_automations/config/automations.json
Added weekly schedule to timmy_automations/config/daily_run.json
Added weekly_narrative_enabled setting to src/config.py

Features

Human-readable output: Easy-to-skim markdown with sections for activity highlights, focus areas, agent activity, and notable events
Graceful degradation: Works even when Gitea is unavailable (uses local cycle data)
Configurable: Can be enabled/disabled via config or TIMMY_WEEKLY_NARRATIVE_ENABLED env var
Vibe classification: Automatically categorizes the week as productive, steady, struggling, or quiet based on metrics

Tests

Comprehensive test suite in tests/timmy_automations/test_weekly_narrative.py
Tests cover data collection, analysis functions, narrative generation, and configuration loading

Usage

# Generate weekly narrative (runs automatically via weekly schedule)
python3 timmy_automations/daily_run/weekly_narrative.py

# Output as JSON
python3 timmy_automations/daily_run/weekly_narrative.py --json

# Force run even if disabled in config
python3 timmy_automations/daily_run/weekly_narrative.py --force

Acceptance Criteria

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

Fixes #719 ## Summary This PR implements a weekly narrative summary generator that creates human-readable summaries of development activity. ## Changes ### New Script - `timmy_automations/daily_run/weekly_narrative.py` — Main script that: - Analyzes the past 7 days of development activity - Extracts themes from issue labels (layers, types) - Identifies agent contributions and activity patterns - Calculates test coverage trends and cycle success rates - Summarizes triage health and token economy shifts - Classifies the overall "vibe" (productive/steady/struggling/quiet) - Outputs both JSON (`.loop/weekly_narrative.json`) and Markdown (`.loop/weekly_narrative.md`) ### Configuration - Added `weekly_narrative` entry to `timmy_automations/config/automations.json` - Added `weekly` schedule to `timmy_automations/config/daily_run.json` - Added `weekly_narrative_enabled` setting to `src/config.py` ### Features - **Human-readable output**: Easy-to-skim markdown with sections for activity highlights, focus areas, agent activity, and notable events - **Graceful degradation**: Works even when Gitea is unavailable (uses local cycle data) - **Configurable**: Can be enabled/disabled via config or `TIMMY_WEEKLY_NARRATIVE_ENABLED` env var - **Vibe classification**: Automatically categorizes the week as productive, steady, struggling, or quiet based on metrics ### Tests - Comprehensive test suite in `tests/timmy_automations/test_weekly_narrative.py` - Tests cover data collection, analysis functions, narrative generation, and configuration loading ## Usage ```bash # Generate weekly narrative (runs automatically via weekly schedule) python3 timmy_automations/daily_run/weekly_narrative.py # Output as JSON python3 timmy_automations/daily_run/weekly_narrative.py --json # Force run even if disabled in config python3 timmy_automations/daily_run/weekly_narrative.py --force ``` ## Acceptance Criteria - [x] Weekly narrative is generated and easy to skim - [x] Timmy can adjust or turn off the feature via config

kimi added 1 commit 2026-03-21 21:36:17 +00:00

feat: add weekly narrative summary generator (#719 )

Tests / lint (pull_request) Has been cancelled

Details

Tests / test (pull_request) Has been cancelled

Details

6582c85690

Add weekly_narrative.py script that generates a human-readable summary of:
- Development themes and focus areas from issue labels
- Agent contributions and activity patterns
- Test coverage trends and cycle success rates
- Triage health and token economy shifts

Features:
- Outputs both JSON (.loop/weekly_narrative.json) and Markdown (.loop/weekly_narrative.md)
- Vibe classification: productive/steady/struggling/quiet
- Gitea API integration for issue/PR data
- Graceful degradation when Gitea unavailable
- Configurable via timmy_automations/config/automations.json
- Environment variable overrides for all settings
- Can be disabled via config or TIMMY_WEEKLY_NARRATIVE_ENABLED env var

Configuration:
- Added weekly_narrative to automations.json manifest
- Added weekly schedule to daily_run.json
- Added weekly_narrative_enabled setting to config.py

Tests:
- Comprehensive test coverage in tests/timmy_automations/test_weekly_narrative.py
- Tests for data collection, analysis, and narrative generation

Refs #719

kimi referenced this pull request

2026-03-21 21:36:31 +00:00

Generate weekly narrative summary of work and vibes #719

kimi merged commit 6dd48685e7 into main

2026-03-21 21:36:41 +00:00

kimi deleted branch kimi/issue-719

2026-03-21 21:36:41 +00:00

kimi referenced this issue from a commit

2026-03-21 21:36:43 +00:00

[kimi] Weekly narrative summary generator (#719) (#791)

Sign in to join this conversation.