daily-summary-agent 0.1.0__tar.gz

daily_summary_agent-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: daily-summary-agent
+Version: 0.1.0
+Summary: AI-powered standup email agent — summarizes your GitHub commits and Jira tickets before every meeting.
+Requires-Python: >=3.11
+Requires-Dist: google-genai>=1.0.0
+Requires-Dist: google-api-python-client>=2.100.0
+Requires-Dist: google-auth-httplib2>=0.2.0
+Requires-Dist: google-auth-oauthlib>=1.2.0
+Requires-Dist: PyGithub>=2.1.0
+Requires-Dist: jira>=3.6.0
+Requires-Dist: APScheduler>=3.10.0
+Requires-Dist: python-dotenv>=1.0.0

daily_summary_agent-0.1.0/README.md

@@ -0,0 +1,119 @@
+# Daily Summary Agent
+
+Automatically emails you a standup summary before every meeting — what you worked on (from GitHub commits), what's in progress (from Jira), and any blockers. Powered by Gemini.
+
+## How it works
+
+1. Runs in the background, checking your Google Calendar every 5 minutes
+2. When a meeting is ~1 hour away, it fetches your recent GitHub commits and active Jira tickets
+3. Generates a concise standup summary using Gemini
+4. Emails it to you before the meeting starts
+
+---
+
+## Setup
+
+### 1. Prerequisites
+
+- Python 3.11+
+- A [Gemini API key](https://aistudio.google.com/app/apikey)
+- A [GitHub Personal Access Token](https://github.com/settings/tokens) with `repo` scope
+- A Google account with Calendar access
+- A Gmail account with [App Passwords](https://myaccount.google.com/apppasswords) enabled (2FA required)
+- _(Optional)_ A Jira account
+
+### 2. Clone and install
+
+```bash
+git clone https://github.com/naga-a11y/daily-summary-agent.git
+cd daily-summary-agent
+
+python3 -m venv env
+source env/bin/activate      # Windows: env\Scripts\activate
+
+pip install -r requirements.txt
+```
+
+### 3. Configure environment
+
+```bash
+cp .env.example .env
+```
+
+Open `.env` and fill in:
+
+| Variable | Where to get it |
+|---|---|
+| `GEMINI_API_KEY` | [aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey) |
+| `GITHUB_TOKEN` | [github.com/settings/tokens](https://github.com/settings/tokens) → Generate new token (classic) → `repo` scope |
+| `GITHUB_USERNAME` | Your GitHub handle (e.g. `john-doe`) |
+| `SMTP_USERNAME` | Your Gmail address |
+| `SMTP_PASSWORD` | Gmail App Password (not your main password) |
+| `EMAIL_FROM` | Your Gmail address |
+| `EMAIL_TO` | Where to send summaries (can be same as FROM) |
+
+Jira variables are optional — leave them blank to skip ticket fetching.
+
+### 4. Connect Google Calendar
+
+Download OAuth credentials from Google Cloud Console:
+
+1. Go to [console.cloud.google.com](https://console.cloud.google.com)
+2. Create a project → **APIs & Services → Enable APIs** → enable **Google Calendar API**
+3. **APIs & Services → Credentials → Create Credentials → OAuth 2.0 Client ID**
+4. Choose **Desktop App**, download the JSON file
+5. Save it as `credentials.json` in the project root
+
+### 5. First run (browser auth)
+
+```bash
+python3 main.py
+```
+
+On first run, a browser window will open asking you to grant Google Calendar access. After you approve, `token.json` is saved automatically and all future runs are silent.
+
+---
+
+## Running
+
+### Directly
+
+```bash
+source env/bin/activate
+python3 main.py
+```
+
+### With Docker
+
+```bash
+# Run once locally first to generate token.json via browser auth (step 5 above)
+# Then:
+docker compose up -d
+docker compose logs -f
+```
+
+---
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `MEETING_ALERT_MINUTES` | `60` | Send email this many minutes before the meeting |
+| `CHECK_INTERVAL_MINUTES` | `5` | How often to poll Google Calendar |
+
+---
+
+## Project structure
+
+```
+main.py                        # Entry point
+config.py                      # Environment variable loading & validation
+src/
+  agent.py                     # Gemini summarization
+  scheduler.py                 # APScheduler polling loop
+  integrations/
+    calendar.py                # Google Calendar
+    github.py                  # GitHub commits
+    jira_client.py             # Jira tickets
+    email_sender.py            # SMTP email
+```

daily_summary_agent-0.1.0/daily_summary_agent/agent.py

@@ -0,0 +1,79 @@
+import logging
+
+from google import genai
+
+from . import config
+
+logger = logging.getLogger(__name__)
+
+_client = genai.Client(api_key=config.GEMINI_API_KEY)
+
+
+def generate_standup_summary(
+    meeting_name: str,
+    meeting_time: str,
+    commits: list[dict],
+    tickets: list[dict],
+) -> tuple[str, str]:
+    """
+    Generate a standup-ready summary using Gemini.
+    Returns (html_content, plain_text_content).
+    """
+    commits_block = (
+        "\n".join(
+            f"  - [{c['sha']}] {c['repo']}: {c['message']}"
+            for c in commits
+        )
+        if commits
+        else "  (no commits found since yesterday)"
+    )
+
+    tickets_block = (
+        "\n".join(
+            f"  - {t['key']} [{t['status']}] ({t['priority']}): {t['summary']}"
+            for t in tickets
+        )
+        if tickets
+        else "  (no active Jira tickets found)"
+    )
+
+    prompt = f"""You are helping a software engineer prepare for their standup meeting.
+
+Meeting: {meeting_name}
+Starting at: {meeting_time}
+
+--- GitHub commits (since yesterday midnight) ---
+{commits_block}
+
+--- Active Jira tickets ---
+{tickets_block}
+
+Write a concise standup summary the engineer can read aloud or copy-paste into Slack.
+Structure it with exactly three sections:
+1. **What I did** — summarize the commits in plain language, grouped by theme if possible
+2. **What I'm working on next** — based on in-progress Jira tickets
+3. **Blockers** — flag anything that looks stuck or needs attention; write "None" if there are no obvious blockers
+
+Rules:
+- Keep each section to 2-4 bullet points max
+- Use past tense for "What I did", present/future tense for the rest
+- Do not include ticket keys or commit SHAs in the spoken summary — keep it human
+
+Respond with two versions separated by the exact delimiter "---PLAINTEXT---":
+1. First: an HTML version using only <h3>, <ul>, <li>, <strong>, <a> tags (no <html>/<body> wrapper)
+2. Second: a plain-text version
+
+HTML version first, then the delimiter, then plain text."""
+
+    response = _client.models.generate_content(
+        model="gemini-2.5-pro",
+        contents=prompt,
+    )
+
+    full_text = response.text or ""
+
+    if "---PLAINTEXT---" in full_text:
+        html_part, plain_part = full_text.split("---PLAINTEXT---", 1)
+        return html_part.strip(), plain_part.strip()
+
+    return full_text.strip(), ""

daily_summary_agent-0.1.0/daily_summary_agent/cli.py

@@ -0,0 +1,100 @@
+import getpass
+import logging
+import os
+import shutil
+import sys
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".daily-summary-agent"
+CONFIG_FILE = CONFIG_DIR / "config.env"
+CREDS_FILE = CONFIG_DIR / "credentials.json"
+
+
+def _write_config(values: dict) -> None:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    lines = [f"{k}={v}" for k, v in values.items() if v]
+    CONFIG_FILE.write_text("\n".join(lines) + "\n")
+    CONFIG_FILE.chmod(0o600)
+
+
+def setup() -> None:
+    print("Daily Summary Agent — Setup\n")
+
+    values = {}
+
+    # Gemini
+    print("1. Gemini API key")
+    print("   Get it at: https://aistudio.google.com/app/apikey")
+    values["GEMINI_API_KEY"] = getpass.getpass("   API key: ").strip()
+
+    # GitHub
+    print("\n2. GitHub")
+    print("   Get a token at: https://github.com/settings/tokens → repo scope")
+    values["GITHUB_TOKEN"] = getpass.getpass("   Personal Access Token: ").strip()
+    values["GITHUB_USERNAME"] = input("   Username: ").strip()
+
+    # Email
+    print("\n3. Gmail")
+    print("   Generate an App Password at: https://myaccount.google.com/apppasswords")
+    email = input("   Gmail address: ").strip()
+    values["SMTP_USERNAME"] = email
+    values["EMAIL_FROM"] = email
+    values["EMAIL_TO"] = email
+    values["SMTP_PASSWORD"] = getpass.getpass("   App Password: ").strip()
+
+    # Jira (optional)
+    print("\n4. Jira (optional — press Enter to skip)")
+    jira_server = input("   Server URL (e.g. https://company.atlassian.net): ").strip()
+    if jira_server:
+        values["JIRA_SERVER"] = jira_server
+        values["JIRA_EMAIL"] = input("   Email: ").strip()
+        values["JIRA_API_TOKEN"] = getpass.getpass("   API token: ").strip()
+        values["JIRA_USERNAME"] = input("   Username: ").strip()
+
+    # Google Calendar credentials.json
+    print("\n5. Google Calendar credentials")
+    print("   Download from: https://console.cloud.google.com")
+    print("   APIs & Services → Credentials → OAuth 2.0 Client ID → Desktop App → Download JSON")
+    creds_path = input("   Path to downloaded credentials.json: ").strip()
+    creds_path = Path(creds_path).expanduser()
+    if creds_path.exists():
+        shutil.copy(creds_path, CREDS_FILE)
+        values["GOOGLE_CREDENTIALS_FILE"] = str(CREDS_FILE)
+        values["GOOGLE_TOKEN_FILE"] = str(CONFIG_DIR / "token.json")
+        print(f"   Copied to {CREDS_FILE}")
+    else:
+        print(f"   File not found — copy it manually to {CREDS_FILE} before starting.")
+
+    _write_config(values)
+    print(f"\nConfig saved to {CONFIG_FILE}")
+    print("\nRun 'daily-summary-agent start' to launch.")
+    print("A browser window will open on first run for Google Calendar access.\n")
+
+
+def start() -> None:
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+        handlers=[logging.StreamHandler(sys.stdout)],
+    )
+
+    if not CONFIG_FILE.exists():
+        print("No configuration found. Run 'daily-summary-agent setup' first.")
+        sys.exit(1)
+
+    from daily_summary_agent.scheduler import run
+    run()
+
+
+def main() -> None:
+    command = sys.argv[1] if len(sys.argv) > 1 else None
+
+    if command == "setup":
+        setup()
+    elif command == "start":
+        start()
+    else:
+        print("Usage:")
+        print("  daily-summary-agent setup   — first-time configuration wizard")
+        print("  daily-summary-agent start   — start the agent")

daily_summary_agent-0.1.0/daily_summary_agent/config.py

@@ -0,0 +1,59 @@
+import os
+import sys
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+CONFIG_DIR = Path.home() / ".daily-summary-agent"
+CONFIG_FILE = CONFIG_DIR / "config.env"
+
+# Load from ~/.daily-summary-agent/config.env (installed) or .env (local dev)
+load_dotenv(CONFIG_FILE)
+load_dotenv()
+
+# Google Calendar
+GOOGLE_CREDENTIALS_FILE = os.getenv("GOOGLE_CREDENTIALS_FILE", str(CONFIG_DIR / "credentials.json"))
+GOOGLE_TOKEN_FILE = os.getenv("GOOGLE_TOKEN_FILE", str(CONFIG_DIR / "token.json"))
+
+# GitHub
+GITHUB_TOKEN = os.getenv("GITHUB_TOKEN")
+GITHUB_USERNAME = os.getenv("GITHUB_USERNAME")
+
+# Jira (optional)
+JIRA_SERVER = os.getenv("JIRA_SERVER")
+JIRA_EMAIL = os.getenv("JIRA_EMAIL")
+JIRA_API_TOKEN = os.getenv("JIRA_API_TOKEN")
+JIRA_USERNAME = os.getenv("JIRA_USERNAME")
+
+# Email
+SMTP_HOST = os.getenv("SMTP_HOST", "smtp.gmail.com")
+SMTP_PORT = int(os.getenv("SMTP_PORT", "587"))
+SMTP_USERNAME = os.getenv("SMTP_USERNAME")
+SMTP_PASSWORD = os.getenv("SMTP_PASSWORD")
+EMAIL_FROM = os.getenv("EMAIL_FROM")
+EMAIL_TO = os.getenv("EMAIL_TO")
+
+# Gemini
+GEMINI_API_KEY = os.getenv("GEMINI_API_KEY")
+
+# Scheduler
+CHECK_INTERVAL_MINUTES = int(os.getenv("CHECK_INTERVAL_MINUTES", "5"))
+MEETING_ALERT_MINUTES = int(os.getenv("MEETING_ALERT_MINUTES", "60"))
+
+_REQUIRED = {
+    "GEMINI_API_KEY": GEMINI_API_KEY,
+    "GITHUB_TOKEN": GITHUB_TOKEN,
+    "GITHUB_USERNAME": GITHUB_USERNAME,
+    "SMTP_USERNAME": SMTP_USERNAME,
+    "SMTP_PASSWORD": SMTP_PASSWORD,
+    "EMAIL_FROM": EMAIL_FROM,
+    "EMAIL_TO": EMAIL_TO,
+}
+
+
+def validate() -> None:
+    missing = [k for k, v in _REQUIRED.items() if not v]
+    if missing:
+        print(f"ERROR: Missing required config: {', '.join(missing)}", file=sys.stderr)
+        print(f"Run 'daily-summary-agent setup' to configure.", file=sys.stderr)
+        sys.exit(1)

daily_summary_agent-0.1.0/daily_summary_agent/integrations/calendar.py

@@ -0,0 +1,97 @@
+import datetime
+import logging
+import os
+
+from google.auth.transport.requests import Request
+from google.oauth2.credentials import Credentials
+from google_auth_oauthlib.flow import InstalledAppFlow
+from googleapiclient.discovery import build
+
+from .. import config
+
+logger = logging.getLogger(__name__)
+
+SCOPES = ["https://www.googleapis.com/auth/calendar.readonly"]
+
+
+def _get_credentials() -> Credentials:
+    creds = None
+
+    if os.path.exists(config.GOOGLE_TOKEN_FILE):
+        creds = Credentials.from_authorized_user_file(config.GOOGLE_TOKEN_FILE, SCOPES)
+
+    if not creds or not creds.valid:
+        if creds and creds.expired and creds.refresh_token:
+            creds.refresh(Request())
+        else:
+            if not os.path.exists(config.GOOGLE_CREDENTIALS_FILE):
+                raise FileNotFoundError(
+                    f"Google credentials file not found: {config.GOOGLE_CREDENTIALS_FILE}\n"
+                    "Run 'daily-summary-agent setup' to configure."
+                )
+            flow = InstalledAppFlow.from_client_secrets_file(
+                config.GOOGLE_CREDENTIALS_FILE, SCOPES
+            )
+            creds = flow.run_local_server(port=0)
+
+        os.makedirs(os.path.dirname(config.GOOGLE_TOKEN_FILE), exist_ok=True)
+        with open(config.GOOGLE_TOKEN_FILE, "w") as f:
+            f.write(creds.to_json())
+        logger.info("Google Calendar token saved to %s", config.GOOGLE_TOKEN_FILE)
+
+    return creds
+
+
+def get_todays_meetings() -> list[dict]:
+    """Return all meetings scheduled for today (local time)."""
+    service = build("calendar", "v3", credentials=_get_credentials())
+
+    now = datetime.datetime.now(datetime.timezone.utc)
+    local_now = now.astimezone()
+    start_of_day = local_now.replace(hour=0, minute=0, second=0, microsecond=0)
+    end_of_day = local_now.replace(hour=23, minute=59, second=59, microsecond=0)
+
+    result = (
+        service.events()
+        .list(
+            calendarId="primary",
+            timeMin=start_of_day.isoformat(),
+            timeMax=end_of_day.isoformat(),
+            singleEvents=True,
+            orderBy="startTime",
+        )
+        .execute()
+    )
+
+    events = result.get("items", [])
+    logger.info(
+        "Today's meetings (%d): %s",
+        len(events),
+        ", ".join(e.get("summary", "(no title)") for e in events) or "none",
+    )
+    return events
+
+
+def get_upcoming_meetings(window_start_minutes: int, window_end_minutes: int) -> list[dict]:
+    """Return meetings whose start time falls between window_start and window_end minutes from now."""
+    service = build("calendar", "v3", credentials=_get_credentials())
+
+    now = datetime.datetime.utcnow()
+    time_min = (now + datetime.timedelta(minutes=window_start_minutes)).isoformat() + "Z"
+    time_max = (now + datetime.timedelta(minutes=window_end_minutes)).isoformat() + "Z"
+
+    result = (
+        service.events()
+        .list(
+            calendarId="primary",
+            timeMin=time_min,
+            timeMax=time_max,
+            singleEvents=True,
+            orderBy="startTime",
+        )
+        .execute()
+    )
+
+    events = result.get("items", [])
+    logger.info("Found %d meeting(s) in the alert window.", len(events))
+    return events

daily_summary_agent-0.1.0/daily_summary_agent/integrations/email_sender.py

@@ -0,0 +1,65 @@
+import logging
+import smtplib
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
+
+from .. import config
+
+logger = logging.getLogger(__name__)
+
+_EMAIL_TEMPLATE = """<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    body {{
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      max-width: 640px;
+      margin: 0 auto;
+      padding: 24px;
+      color: #24292f;
+      background: #ffffff;
+    }}
+    h2 {{ color: #1a1a2e; border-bottom: 2px solid #e6edf3; padding-bottom: 10px; }}
+    h3 {{ color: #0969da; margin-top: 24px; }}
+    ul {{ padding-left: 20px; line-height: 1.7; }}
+    li {{ margin: 4px 0; }}
+    a {{ color: #0969da; text-decoration: none; }}
+    a:hover {{ text-decoration: underline; }}
+    .footer {{
+      margin-top: 36px;
+      padding-top: 16px;
+      border-top: 1px solid #e6edf3;
+      color: #8b949e;
+      font-size: 12px;
+    }}
+  </style>
+</head>
+<body>
+  {content}
+  <div class="footer">
+    Generated by <a href="https://github.com/naga-a11y/daily-summary-agent">Daily Summary Agent</a>
+  </div>
+</body>
+</html>"""
+
+
+def send_email(subject: str, html_content: str, plain_content: str = "") -> None:
+    msg = MIMEMultipart("alternative")
+    msg["Subject"] = subject
+    msg["From"] = config.EMAIL_FROM
+    msg["To"] = config.EMAIL_TO
+
+    html_body = _EMAIL_TEMPLATE.format(content=html_content)
+
+    if plain_content:
+        msg.attach(MIMEText(plain_content, "plain", "utf-8"))
+    msg.attach(MIMEText(html_body, "html", "utf-8"))
+
+    with smtplib.SMTP(config.SMTP_HOST, config.SMTP_PORT) as server:
+        server.ehlo()
+        server.starttls()
+        server.login(config.SMTP_USERNAME, config.SMTP_PASSWORD)
+        server.sendmail(config.EMAIL_FROM, [config.EMAIL_TO], msg.as_string())
+
+    logger.info("Email sent to %s: %s", config.EMAIL_TO, subject)

daily_summary_agent-0.1.0/daily_summary_agent/integrations/github.py

@@ -0,0 +1,73 @@
+import datetime
+import itertools
+import logging
+
+import github
+from github import Github, GithubException
+
+from .. import config
+
+logger = logging.getLogger(__name__)
+
+
+def get_recent_commits() -> list[dict]:
+    """
+    Return commits pushed by the configured user from yesterday midnight (local time) until now.
+    Checks all branches so feature-branch / PR commits are included.
+    """
+    if not config.GITHUB_TOKEN or not config.GITHUB_USERNAME:
+        logger.warning("GitHub credentials not configured — skipping commit fetch.")
+        return []
+
+    g = Github(auth=github.Auth.Token(config.GITHUB_TOKEN))
+
+    local_now = datetime.datetime.now().astimezone()
+    yesterday_midnight = (local_now - datetime.timedelta(days=1)).replace(
+        hour=0, minute=0, second=0, microsecond=0
+    )
+    since = yesterday_midnight.astimezone(datetime.timezone.utc)
+
+    pushed_repos = set()
+    try:
+        user = g.get_user(config.GITHUB_USERNAME)
+        for event in user.get_events():
+            event_time = event.created_at.replace(tzinfo=datetime.timezone.utc)
+            if event_time < since:
+                break
+            if event.type == "PushEvent":
+                pushed_repos.add(event.repo.name)
+    except GithubException as e:
+        logger.error("GitHub Events API error: %s", e)
+        return []
+
+    seen_shas = set()
+    commits = []
+    for repo_name in pushed_repos:
+        try:
+            repo = g.get_repo(repo_name)
+            for branch in repo.get_branches():
+                for commit in itertools.islice(
+                    repo.get_commits(sha=branch.name, author=config.GITHUB_USERNAME, since=since),
+                    50,
+                ):
+                    if commit.sha in seen_shas:
+                        continue
+                    seen_shas.add(commit.sha)
+                    commits.append(
+                        {
+                            "repo": repo_name,
+                            "sha": commit.sha[:7],
+                            "message": commit.commit.message.split("\n")[0],
+                            "url": commit.html_url,
+                            "timestamp": commit.commit.author.date.isoformat(),
+                        }
+                    )
+        except GithubException as e:
+            logger.warning("Could not fetch commits for %s: %s", repo_name, e)
+
+    logger.info(
+        "Fetched %d commit(s) from GitHub (since %s).",
+        len(commits),
+        yesterday_midnight.strftime("%Y-%m-%d %H:%M %Z"),
+    )
+    return commits

daily_summary_agent-0.1.0/daily_summary_agent/integrations/jira_client.py

@@ -0,0 +1,49 @@
+import logging
+
+from jira import JIRA, JIRAError
+
+from .. import config
+
+logger = logging.getLogger(__name__)
+
+
+def _get_client() -> JIRA:
+    return JIRA(
+        server=config.JIRA_SERVER,
+        basic_auth=(config.JIRA_EMAIL, config.JIRA_API_TOKEN),
+    )
+
+
+def get_active_tickets() -> list[dict]:
+    """Return open tickets assigned to the configured user, ordered by last update."""
+    if not config.JIRA_SERVER or not config.JIRA_EMAIL or not config.JIRA_API_TOKEN:
+        logger.warning("Jira credentials not configured — skipping ticket fetch.")
+        return []
+
+    try:
+        client = _get_client()
+        jql = (
+            f'assignee = "{config.JIRA_USERNAME}" '
+            f'AND status NOT IN (Done, Closed, Resolved, Cancelled) '
+            f'ORDER BY updated DESC'
+        )
+        issues = client.search_issues(jql, maxResults=25)
+
+        tickets = []
+        for issue in issues:
+            tickets.append(
+                {
+                    "key": issue.key,
+                    "summary": issue.fields.summary,
+                    "status": issue.fields.status.name,
+                    "priority": getattr(issue.fields.priority, "name", "—"),
+                    "url": f"{config.JIRA_SERVER}/browse/{issue.key}",
+                }
+            )
+
+        logger.info("Fetched %d Jira ticket(s).", len(tickets))
+        return tickets
+
+    except JIRAError as e:
+        logger.error("Jira API error: %s", e.text)
+        return []

daily_summary_agent-0.1.0/daily_summary_agent/scheduler.py

@@ -0,0 +1,125 @@
+import json
+import logging
+import os
+import signal
+import sys
+from datetime import datetime, timezone
+
+from apscheduler.schedulers.blocking import BlockingScheduler
+
+from . import config
+from .agent import generate_standup_summary
+from .integrations.calendar import get_todays_meetings, get_upcoming_meetings
+from .integrations.email_sender import send_email
+from .integrations.github import get_recent_commits
+from .integrations.jira_client import get_active_tickets
+
+logger = logging.getLogger(__name__)
+
+_SENT_FILE = os.path.join(config.CONFIG_DIR, "sent_meetings.json")
+
+
+def _load_sent() -> dict:
+    if os.path.exists(_SENT_FILE):
+        try:
+            with open(_SENT_FILE, encoding="utf-8") as f:
+                return json.load(f)
+        except json.JSONDecodeError:
+            logger.warning("sent_meetings.json is corrupt — resetting.")
+    return {}
+
+
+def _save_sent(sent: dict) -> None:
+    os.makedirs(config.CONFIG_DIR, exist_ok=True)
+    with open(_SENT_FILE, "w", encoding="utf-8") as f:
+        json.dump(sent, f, indent=2)
+
+
+def _meeting_display_time(event: dict) -> str:
+    start = event.get("start", {})
+    dt_str = start.get("dateTime") or start.get("date", "")
+    try:
+        dt = datetime.fromisoformat(dt_str.replace("Z", "+00:00"))
+        return dt.astimezone().strftime("%I:%M %p")
+    except ValueError:
+        return dt_str
+
+
+def check_and_send() -> None:
+    alert = config.MEETING_ALERT_MINUTES
+    slack = config.CHECK_INTERVAL_MINUTES // 2 + 1
+    events = get_upcoming_meetings(
+        window_start_minutes=alert - slack,
+        window_end_minutes=alert + slack,
+    )
+
+    if not events:
+        logger.debug("No meetings in alert window.")
+        return
+
+    sent = _load_sent()
+    commits = None
+    tickets = None
+
+    for event in events:
+        meeting_id = event.get("id")
+        if not meeting_id or meeting_id in sent:
+            continue
+
+        meeting_name = event.get("summary", "Standup")
+        logger.info("Preparing summary for: %s", meeting_name)
+
+        try:
+            if commits is None:
+                commits = get_recent_commits()
+            if tickets is None:
+                tickets = get_active_tickets()
+
+            meeting_time = _meeting_display_time(event)
+            html_content, plain_content = generate_standup_summary(
+                meeting_name=meeting_name,
+                meeting_time=meeting_time,
+                commits=commits,
+                tickets=tickets,
+            )
+
+            subject = f"Standup prep: {meeting_name} at {meeting_time}"
+            send_email(subject=subject, html_content=html_content, plain_content=plain_content)
+
+            sent[meeting_id] = datetime.now(timezone.utc).isoformat()
+            _save_sent(sent)
+            logger.info("Summary sent for meeting: %s", meeting_name)
+
+        except Exception:
+            logger.exception("Failed to send summary for %s — will retry next cycle.", meeting_name)
+
+
+def run() -> None:
+    config.validate()
+
+    logger.info(
+        "Scheduler starting — checking every %d min, alerting %d min before meetings.",
+        config.CHECK_INTERVAL_MINUTES,
+        config.MEETING_ALERT_MINUTES,
+    )
+
+    scheduler = BlockingScheduler(timezone="UTC")
+
+    def _shutdown(signum, _frame):
+        logger.info("Received signal %d — shutting down.", signum)
+        scheduler.shutdown(wait=False)
+        sys.exit(0)
+
+    signal.signal(signal.SIGTERM, _shutdown)
+    signal.signal(signal.SIGINT, _shutdown)
+
+    get_todays_meetings()
+    check_and_send()
+
+    scheduler.add_job(
+        check_and_send,
+        "interval",
+        minutes=config.CHECK_INTERVAL_MINUTES,
+        id="meeting_check",
+    )
+    scheduler.start()

daily_summary_agent-0.1.0/daily_summary_agent.egg-info/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: daily-summary-agent
+Version: 0.1.0
+Summary: AI-powered standup email agent — summarizes your GitHub commits and Jira tickets before every meeting.
+Requires-Python: >=3.11
+Requires-Dist: google-genai>=1.0.0
+Requires-Dist: google-api-python-client>=2.100.0
+Requires-Dist: google-auth-httplib2>=0.2.0
+Requires-Dist: google-auth-oauthlib>=1.2.0
+Requires-Dist: PyGithub>=2.1.0
+Requires-Dist: jira>=3.6.0
+Requires-Dist: APScheduler>=3.10.0
+Requires-Dist: python-dotenv>=1.0.0

daily_summary_agent-0.1.0/daily_summary_agent.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+daily_summary_agent/__init__.py
+daily_summary_agent/agent.py
+daily_summary_agent/cli.py
+daily_summary_agent/config.py
+daily_summary_agent/scheduler.py
+daily_summary_agent.egg-info/PKG-INFO
+daily_summary_agent.egg-info/SOURCES.txt
+daily_summary_agent.egg-info/dependency_links.txt
+daily_summary_agent.egg-info/entry_points.txt
+daily_summary_agent.egg-info/requires.txt
+daily_summary_agent.egg-info/top_level.txt
+daily_summary_agent/integrations/__init__.py
+daily_summary_agent/integrations/calendar.py
+daily_summary_agent/integrations/email_sender.py
+daily_summary_agent/integrations/github.py
+daily_summary_agent/integrations/jira_client.py

daily_summary_agent-0.1.0/daily_summary_agent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

daily_summary_agent-0.1.0/daily_summary_agent.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+daily-summary-agent = daily_summary_agent.cli:main

daily_summary_agent-0.1.0/daily_summary_agent.egg-info/requires.txt

@@ -0,0 +1,8 @@
+google-genai>=1.0.0
+google-api-python-client>=2.100.0
+google-auth-httplib2>=0.2.0
+google-auth-oauthlib>=1.2.0
+PyGithub>=2.1.0
+jira>=3.6.0
+APScheduler>=3.10.0
+python-dotenv>=1.0.0

daily_summary_agent-0.1.0/daily_summary_agent.egg-info/top_level.txt

@@ -0,0 +1 @@
+daily_summary_agent

daily_summary_agent-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "daily-summary-agent"
+version = "0.1.0"
+description = "AI-powered standup email agent — summarizes your GitHub commits and Jira tickets before every meeting."
+requires-python = ">=3.11"
+dependencies = [
+    "google-genai>=1.0.0",
+    "google-api-python-client>=2.100.0",
+    "google-auth-httplib2>=0.2.0",
+    "google-auth-oauthlib>=1.2.0",
+    "PyGithub>=2.1.0",
+    "jira>=3.6.0",
+    "APScheduler>=3.10.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.scripts]
+daily-summary-agent = "daily_summary_agent.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["daily_summary_agent*"]

daily_summary_agent-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+