standup-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sathvic Kollu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+# standup-mcp
+
+**Generate your daily standup from what you actually did, across GitHub, Jira, Linear, and Slack.**
+
+[![npm version](https://img.shields.io/npm/v/standup-mcp.svg)](https://www.npmjs.com/package/standup-mcp)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/Model%20Context%20Protocol-server-7b5cff.svg)](https://modelcontextprotocol.io)
+
+Every standup, you stop and reconstruct yesterday from memory: which commits, which PR, which ticket you moved, that Slack thread where you said you were stuck. The work is already recorded across your tools. Re-typing it is the chore everyone hates, so updates come out vague ("worked on the thing") and real blockers go unsaid.
+
+`standup-mcp` reads that activity back and writes the draft for you. You ask your AI assistant "what should I say at standup today?" and it answers from your real GitHub, Jira, Linear, and Slack activity: grouped by work item, in concrete deltas, with blockers it noticed on its own.
+
+It is a standard [Model Context Protocol](https://modelcontextprotocol.io) server, so it works in any MCP client (Claude, Cursor, Cline, and more) on any model. It is **local and read-only**: nothing about your activity leaves your machine except the calls to those tools' own APIs, and it needs **no AI API key of its own**. The host client supplies the model.
+
+## See it in 30 seconds (no accounts needed)
+
+The server ships with a realistic demo dataset and runs against it automatically when no credentials are set, so you see the output before connecting anything:
+
+```bash
+npx -y standup-mcp --demo
+```
+
+That prints a full standup from a synthetic day across all four tools. Here is the headline tool:
+
+```
+# Standup: Jordan Lee
+_since Tue Jun 16. Demo data, no credentials configured._
+
+## Yesterday
+- **PROJ-412 Biometric re-auth** · opened PR #128, 3 commits, latest "handle expired challenge edge case", moved to In Progress, posted an update
+- **ENG-88 Rate-limit the export endpoint** · 2 commits, latest "tests for limiter window", moved to In Progress, posted an update
+- **PROJ-407 Card dispute webhook** · merged PR #125, moved to In Review
+- Reviewed PR #129: Tidy currency formatting helpers
+
+## Today
+- Continue **PROJ-412 Biometric re-auth**
+- Continue **ENG-88 Rate-limit the export endpoint**
+- Land PR #128: Add biometric re-auth (review pending)
+- Review PR #130: Refactor request logging
+
+## Blockers
+- 🔴 **PROJ-412 Biometric re-auth** · flagged blocked: "Blocked on the vendor sandbox creds for PROJ-412. Waiting on infra to provision them before I can test the re-auth flow…"; awaiting review
+```
+
+Notice the GitHub commits, the GitHub PR, and the Jira move all collapsed under **PROJ-412**, and the blocker was lifted from a Slack message on its own. Nobody typed any of that.
+
+(Running `npx -y standup-mcp` with no flag starts the MCP server on stdio, which is what an MCP client launches. Use `--demo` to see output in a plain terminal.)
+
+## What it does
+
+Five tools. Every one defaults to the last working day, and Monday automatically reaches back across the weekend, so you rarely pass arguments.
+
+| Tool | What you get |
+| --- | --- |
+| `standup_draft` | Your standup: Yesterday / Today / Blockers, grouped by work item, in concrete deltas. The answer to "what should I say at standup?" |
+| `blocker_scan` | Everything blocking you, ranked by severity, fused from explicit "blocked / waiting on" language, PRs awaiting review, stalled in-progress tickets, and help requests. |
+| `weekly_summary` | A week of activity rolled into Shipped vs In progress, with reviews and totals. For 1:1s, weekly status, and self-reviews. |
+| `activity_digest` | A chronological "what actually happened" across all tools, newest first, grouped by day. |
+| `list_sources` | Which sources are wired, or that you are on demo data. |
+
+### What you can ask
+
+You talk to it in plain language through your AI client:
+
+- "What should I say at standup today?"
+- "Give me Monday's standup covering the weekend."
+- "What is blocking me right now?"
+- "Summarize what I shipped this week for my 1:1."
+- "What did I actually do yesterday?"
+
+### Principles it follows
+
+- **Only observed activity.** It reports commits, PRs, ticket moves, and messages that exist. It never invents progress to fill a quiet day; a quiet day is reported as one.
+- **Grouped by work item, not by tool.** Reviewers think in tickets, so the commit, the PR, the Jira move, and the Slack thread for PROJ-412 become one line, not four.
+- **Blockers from signals, not self-report.** People forget to say they are stuck, so it infers it.
+- **A draft, not an auto-post.** You get editable markdown to paste wherever your team already does standup (Slack, Geekbot, a doc, a ticket). It does not post on your behalf.
+
+<details>
+<summary><b>Example: blocker_scan</b></summary>
+
+```
+# Blockers
+_since Tue Jun 16. Demo data._
+
+**1 blocker**: 1 high, 0 medium, 0 low.
+
+- 🔴 **PROJ-412 Biometric re-auth** (slack) · flagged blocked: "Blocked on the vendor sandbox creds for PROJ-412. Waiting on infra to provision them before I can test the re-auth flow…"; awaiting review
+```
+</details>
+
+<details>
+<summary><b>Example: weekly_summary</b></summary>
+
+```
+# Weekly summary: Jordan Lee
+_the last 7 days. Demo data._
+
+## Shipped
+- **PROJ-407 Card dispute webhook**
+
+## In progress
+- **PROJ-412 Biometric re-auth**
+- **ENG-88 Rate-limit the export endpoint**
+
+## Reviews and support
+- Reviewed 1 PR for teammates
+
+_3 work items touched, 1 PR merged, 5 commits._
+```
+</details>
+
+## Privacy
+
+This is the part most tools gloss over. `standup-mcp` is built so that using it does not feel like installing surveillance on yourself:
+
+- **Local.** It runs on your machine, inside your AI client. There is no standup-mcp server or account.
+- **Read-only.** Every token it asks for is used only to read your activity. It never writes, posts, or moves anything.
+- **No AI key, no third party.** It makes no LLM calls of its own. Your activity is sent only to the APIs of the tools you connect, and to your existing AI client's model. It is not sent to me or anyone else.
+- **It is yours, not your manager's.** It generates your own update for you to review and edit, not a feed of your activity for someone else.
+
+## Connect your tools
+
+Set any subset. Whatever you configure, it uses; with nothing set, it stays in demo mode. Restart the server after changing these.
+
+| Variable | Source | Notes |
+| --- | --- | --- |
+| `GITHUB_TOKEN` | GitHub | Read-only PAT. Reads your commits, PRs, and reviews. |
+| `JIRA_BASE_URL` `JIRA_EMAIL` `JIRA_API_TOKEN` | Jira | Cloud site, account email, and an [API token](https://id.atlassian.com/manage-profile/security/api-tokens). Reads your ticket moves. |
+| `LINEAR_API_KEY` | Linear | A [personal API key](https://linear.app/settings/api). Reads your issue state changes and comments. |
+| `SLACK_TOKEN` | Slack | A user token (`xoxp`) with `search:read` scans your own messages for blocker language. With a bot token instead, also set `SLACK_CHANNELS` (comma-separated channel ids) since bots cannot search. |
+| `STANDUP_NAME` | optional | Display name for the standup's owner. Without it, the GitHub handle is used. |
+
+Verify your connections before wiring it into a client:
+
+```bash
+GITHUB_TOKEN=ghp_xxx LINEAR_API_KEY=lin_xxx npx -y standup-mcp --check
+```
+
+It prints, per source, the authenticated identity or a clear error.
+
+## Connect your AI client
+
+`standup-mcp` speaks the Model Context Protocol, so any MCP-capable client can use it, whichever model is behind it: Claude Desktop, Claude Code, Cursor, Cline, Continue, Zed, Windsurf, and more. The server uses no AI API key of its own.
+
+### Claude Desktop
+
+Add this to `claude_desktop_config.json` (Settings, Developer, Edit Config), then restart Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "standup": {
+      "command": "npx",
+      "args": ["-y", "standup-mcp"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_your_token",
+        "JIRA_BASE_URL": "https://your-company.atlassian.net",
+        "JIRA_EMAIL": "you@company.com",
+        "JIRA_API_TOKEN": "your-jira-token",
+        "LINEAR_API_KEY": "lin_api_your_key",
+        "SLACK_TOKEN": "xoxp-your-token"
+      }
+    }
+  }
+}
+```
+
+Leave the `env` block out entirely to run in demo mode first. Include only the sources you use.
+
+### Claude Code
+
+```bash
+claude mcp add standup \
+  -e GITHUB_TOKEN=ghp_your_token \
+  -e LINEAR_API_KEY=lin_api_your_key \
+  -- npx -y standup-mcp
+```
+
+### Cursor, Cline, Continue, Zed, Windsurf, and others
+
+These read the same `mcpServers` JSON as Claude Desktop, in the client's own MCP config. Use the block above. The server is identical; only the model driving the client differs.
+
+## How it works
+
+The design goal is a clean seam between each tool and the standup logic.
+
+- **One activity model.** GitHub commits, Jira moves, Linear state changes, and Slack messages all normalize to a single `ActivityEvent`. Nothing downstream knows which tool a fact came from, which is exactly what lets it group by work item across tools.
+- **One provider, many sources.** Each source is an independent read-only client behind a common interface. The aggregator fans out to whichever are configured and tolerates any one failing, so a misconfigured Slack token never sinks your standup.
+- **Pure-function engine.** Grouping, blocker detection, and the draft are pure functions over normalized events. They run identically on demo data and live data, and the tests run them directly.
+- **No model in the server.** The server assembles a factual draft; your AI client phrases it. That is why it needs no AI key and why it can promise it never invents work.
+
+```
+src/
+  index.ts            MCP server, stdio transport, --demo/--check/--help
+  config.ts           per-source env resolution, demo-mode detection
+  window.ts           the weekend-aware "since last standup" window
+  provider.ts         aggregator that fans out to configured sources
+  types.ts            ActivityEvent and the source/provider interfaces
+  normalize.ts        work-item key extraction, signal and noise detection
+  sources/            github, jira, linear, slack clients, plus the demo provider
+  analytics/          grouping, blockers, draft, weekly, digest (pure functions)
+  tools/              one MCP tool per file, thin wrappers over analytics
+```
+
+## What has been verified
+
+- All five tools run end to end over real MCP stdio (`npm test`).
+- The parse heuristics (work-item keys, blocker language, noise filters) are unit tested (`test/normalize.test.ts`).
+- The engine is unit tested, including the Monday-covers-the-weekend window, work-item grouping, blocker severity, and the assembled draft (`test/draft.test.ts`).
+- The whole engine is exercised against the demo dataset and reconciles across tools (`npm run smoke`).
+
+The demo dataset proves the engine. It does not prove each live client against every real account shape, which is why the parse layer is unit tested separately and each source is kept small and tolerant. Run `--check` to confirm your own connections, and if a response shape does not parse cleanly on your account, open an issue.
+
+## Roadmap
+
+- A `team_standup` view that rolls up several people for the PM running the meeting
+- Calendar sources (meetings as activity, so a meeting-heavy day reads honestly)
+- GitLab and Bitbucket
+- Cycle-time and "what changed since I last looked" digests
+- OAuth flows in addition to tokens
+
+## Built by Sathvic Kollu
+
+I run delivery for SaaS and fintech teams, and I build tools like this with Claude Code. If this saves you the daily standup chore, I would like to hear how you use it.
+
+- Website: [sathvickollu.com](https://sathvickollu.com)
+- LinkedIn: [linkedin.com/in/sathvic-kollu](https://www.linkedin.com/in/sathvic-kollu)
+
+Issues and pull requests are welcome.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/analytics/blockers.js

@@ -0,0 +1,122 @@
+/**
+ * Blocker detection by signal fusion, not self-report.
+ *
+ * People forget to say they are blocked. So instead of asking, we infer it from
+ * what the tools already show: explicit "blocked / waiting on" language, a PR
+ * that has been awaiting review, an in-progress ticket that has not moved, or a
+ * request for help. Each candidate event/open-item carries Signal[]; we map
+ * those to a severity and a human reason, then rank.
+ */
+import { daysBetween, heading, plural } from "../format.js";
+import { truncate } from "../normalize.js";
+const RANK = { high: 3, medium: 2, low: 1 };
+function severityForSignal(signal, ageDays) {
+    switch (signal) {
+        case "blocked":
+            return "high";
+        case "review_pending":
+            return ageDays >= 2 ? "high" : "medium";
+        case "stale":
+            return "medium";
+        case "help_requested":
+            return "low";
+    }
+}
+function reasonForSignal(signal, ageDays, body) {
+    switch (signal) {
+        case "blocked": {
+            const snippet = body ? truncate(body, 120) : "";
+            return snippet ? `flagged blocked: "${snippet}"` : "flagged as blocked";
+        }
+        case "review_pending":
+            return ageDays >= 1
+                ? `awaiting review for ${ageDays}d`
+                : "awaiting review";
+        case "stale":
+            return ageDays >= 1
+                ? `in progress ${ageDays}d with no recent movement`
+                : "in progress with no recent movement";
+        case "help_requested":
+            return "asked for help, no answer yet";
+    }
+}
+/**
+ * Detect blockers across this window's activity and the current open items.
+ * `nowIso` anchors staleness/age math.
+ */
+export function detectBlockers(events, openItems, nowIso) {
+    const all = [...events, ...openItems];
+    const candidates = all.filter((e) => e.signals.length > 0);
+    // Borrow the real work-item title from any event that has one, so a blocker
+    // surfaced from a Slack message (which has no title) still reads as the
+    // ticket it is about, not the raw message text.
+    const titles = new Map();
+    for (const e of all) {
+        if (e.workItem && e.workItemTitle && !titles.has(e.workItem)) {
+            titles.set(e.workItem, e.workItemTitle);
+        }
+    }
+    // Dedupe by work item (or title) so the same blocked ticket surfaced from two
+    // sources collapses to one entry, merging reasons.
+    const byKey = new Map();
+    for (const e of candidates) {
+        const ageDays = daysBetween(e.timestamp, nowIso);
+        let severity = "low";
+        const reasons = [];
+        for (const sig of e.signals) {
+            const sev = severityForSignal(sig, ageDays);
+            if (RANK[sev] > RANK[severity])
+                severity = sev;
+            reasons.push(reasonForSignal(sig, ageDays, e.body));
+        }
+        if (reasons.length === 0)
+            continue;
+        const dedupeKey = e.workItem ?? e.title;
+        const existing = byKey.get(dedupeKey);
+        if (existing) {
+            for (const r of reasons) {
+                if (!existing.reasons.includes(r))
+                    existing.reasons.push(r);
+            }
+            if (RANK[severity] > RANK[existing.severity])
+                existing.severity = severity;
+        }
+        else {
+            byKey.set(dedupeKey, {
+                key: e.workItem,
+                title: (e.workItem && titles.get(e.workItem)) ?? e.workItemTitle ?? e.title,
+                severity,
+                reasons,
+                source: e.source,
+                url: e.url,
+            });
+        }
+    }
+    return [...byKey.values()].sort((a, b) => RANK[b.severity] - RANK[a.severity]);
+}
+const SEV_ICON = {
+    high: "🔴",
+    medium: "🟡",
+    low: "🔵",
+};
+/** Standalone blocker report, used by the blocker_scan tool and the demo. */
+export function formatBlockerReport(blockers, window, isDemo) {
+    const out = [];
+    out.push(heading(1, "Blockers"));
+    out.push(`_${window.label}${isDemo ? ". Demo data." : ""}_`);
+    out.push("");
+    if (blockers.length === 0) {
+        out.push("No blockers detected. Nothing is flagged, stalled, or awaiting a review.");
+        return out.join("\n");
+    }
+    const high = blockers.filter((b) => b.severity === "high").length;
+    const med = blockers.filter((b) => b.severity === "medium").length;
+    const low = blockers.filter((b) => b.severity === "low").length;
+    out.push(`**${plural(blockers.length, "blocker")}**: ${high} high, ${med} medium, ${low} low.`);
+    out.push("");
+    for (const b of blockers) {
+        const label = b.key ? `${b.key} ${b.title}` : b.title;
+        out.push(`- ${SEV_ICON[b.severity]} **${truncate(label, 80)}** (${b.source}) · ${b.reasons.join("; ")}`);
+    }
+    return out.join("\n");
+}

package/dist/analytics/digest.js

@@ -0,0 +1,35 @@
+/**
+ * Chronological digest: "what actually happened" in a window, newest first,
+ * grouped by day. Useful for reconstructing a stretch of work or filling in a
+ * timesheet, separate from the opinionated standup framing.
+ */
+import { fmtDayDate, fmtTime, heading, sourceLabel, plural } from "../format.js";
+import { truncate } from "../normalize.js";
+function dayKey(iso) {
+    return iso.slice(0, 10); // YYYY-MM-DD (UTC)
+}
+export function buildDigest(events, window, isDemo = false) {
+    const out = [];
+    out.push(heading(1, "Activity digest"));
+    out.push(`_${window.label}${isDemo ? ". Demo data." : ""}_`);
+    out.push("");
+    if (events.length === 0) {
+        out.push("_No tracked activity in this window._");
+        return out.join("\n");
+    }
+    const sorted = [...events].sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));
+    let currentDay = "";
+    for (const e of sorted) {
+        const dk = dayKey(e.timestamp);
+        if (dk !== currentDay) {
+            currentDay = dk;
+            out.push("");
+            out.push(heading(2, fmtDayDate(e.timestamp)));
+        }
+        const item = e.workItem ? `${e.workItem} · ` : "";
+        out.push(`- ${fmtTime(e.timestamp)} [${sourceLabel(e.source)}] ${item}${truncate(e.title, 100)}`);
+    }
+    out.push("");
+    out.push(`_${plural(events.length, "event")} across the window._`);
+    return out.join("\n");
+}

package/dist/analytics/draft.js

@@ -0,0 +1,129 @@
+/**
+ * Assemble the standup draft: Yesterday / Today / Blockers, grouped by work
+ * item, in concrete deltas.
+ *
+ * This is deterministic. The server makes no LLM call; it turns observed events
+ * into a clean, paste-ready draft and never invents work that is not in the
+ * data. The host AI client can rephrase the tone, but the facts come from here.
+ */
+import { groupByWorkItem, OTHER_KEY } from "./grouping.js";
+import { detectBlockers } from "./blockers.js";
+import { plural, heading } from "../format.js";
+import { truncate } from "../normalize.js";
+const SEV_ICON = { high: "🔴", medium: "🟡", low: "🔵" };
+/** Pull the "#123" reference out of an event title, if present. */
+function ref(e) {
+    const m = e.title.match(/#\d+/);
+    return m ? ` ${m[0]}` : "";
+}
+/** Collapse a work item's events into one concrete delta line. */
+function summarizeGroup(group) {
+    const e = group.events;
+    const parts = [];
+    const merged = e.filter((x) => x.kind === "pr_merged");
+    const opened = e.filter((x) => x.kind === "pr_opened");
+    const reviewed = e.filter((x) => x.kind === "pr_reviewed");
+    const commits = e.filter((x) => x.kind === "commit");
+    const moves = e.filter((x) => x.kind === "issue_moved");
+    const created = e.filter((x) => x.kind === "issue_created");
+    const talked = e.filter((x) => x.kind === "issue_commented" || x.kind === "message");
+    for (const m of merged)
+        parts.push(`merged PR${ref(m)}`);
+    for (const o of opened)
+        parts.push(`opened PR${ref(o)}`);
+    if (commits.length) {
+        const latest = commits[commits.length - 1];
+        const tail = commits.length <= 3 ? `, latest "${truncate(latest.title, 56)}"` : "";
+        parts.push(`${plural(commits.length, "commit")}${tail}`);
+    }
+    if (created.length)
+        parts.push("created the ticket");
+    if (moves.length) {
+        const last = moves[moves.length - 1];
+        if (last.toStatus)
+            parts.push(`moved to ${last.toStatus}`);
+        else
+            parts.push("status updated");
+    }
+    for (const r of reviewed)
+        parts.push(`reviewed PR${ref(r)}`);
+    if (talked.length)
+        parts.push("posted an update");
+    return parts.join(", ") || "activity recorded";
+}
+function renderYesterday(groups) {
+    const lines = [];
+    for (const g of groups) {
+        if (g.key === OTHER_KEY)
+            continue;
+        const label = g.title ? `${g.key} ${g.title}` : g.key;
+        lines.push(`- **${label}** · ${summarizeGroup(g)}`);
+    }
+    const other = groups.find((g) => g.key === OTHER_KEY);
+    if (other) {
+        const items = other.events
+            .slice(-4)
+            .map((e) => truncate(e.title, 90));
+        for (const it of items)
+            lines.push(`- ${it}`);
+    }
+    return lines.length
+        ? lines.join("\n")
+        : "_No tracked activity in this window. Likely meetings, planning, or research._";
+}
+function renderToday(openItems) {
+    const lines = [];
+    const inProgress = openItems.filter((e) => e.kind === "issue_moved");
+    const myPRs = openItems.filter((e) => e.kind === "pr_opened");
+    const toReview = openItems.filter((e) => e.kind === "pr_review_requested");
+    for (const i of inProgress) {
+        const label = i.workItem
+            ? `${i.workItem} ${i.workItemTitle ?? ""}`.trim()
+            : i.title;
+        lines.push(`- Continue **${label}**`);
+    }
+    for (const p of myPRs) {
+        const pending = p.signals.includes("review_pending")
+            ? " (review pending)"
+            : "";
+        lines.push(`- Land PR${ref(p)}: ${truncate(stripPrefix(p.title), 80)}${pending}`);
+    }
+    for (const r of toReview) {
+        lines.push(`- Review PR${ref(r)}: ${truncate(stripPrefix(r.title), 80)}`);
+    }
+    return lines.length
+        ? lines.join("\n")
+        : "_Nothing queued from your tracked tools. Add your plan here._";
+}
+/** Drop a leading "Opened PR #128: " / "Review PR #130: " label from a title. */
+function stripPrefix(title) {
+    return title.replace(/^[^:]*#\d+:\s*/, "").trim() || title;
+}
+function renderBlockers(blockers) {
+    if (blockers.length === 0)
+        return "_None flagged._";
+    return blockers
+        .map((b) => {
+        const label = b.key ? `${b.key} ${b.title}` : b.title;
+        return `- ${SEV_ICON[b.severity]} **${truncate(label, 80)}** · ${b.reasons.join("; ")}`;
+    })
+        .join("\n");
+}
+export function buildStandupDraft(input) {
+    const { actor, window, events, openItems, nowIso, isDemo } = input;
+    const groups = groupByWorkItem(events);
+    const blockers = detectBlockers(events, openItems, nowIso);
+    const out = [];
+    out.push(heading(1, `Standup: ${actor.displayName}`));
+    out.push(`_${window.label}${isDemo ? ". Demo data, no credentials configured." : ""}_`);
+    out.push("");
+    out.push(heading(2, "Yesterday"));
+    out.push(renderYesterday(groups));
+    out.push("");
+    out.push(heading(2, "Today"));
+    out.push(renderToday(openItems));
+    out.push("");
+    out.push(heading(2, "Blockers"));
+    out.push(renderBlockers(blockers));
+    return out.join("\n");
+}

package/dist/analytics/grouping.js

@@ -0,0 +1,44 @@
+/**
+ * Group activity by work item, not by tool.
+ *
+ * Reviewers and PMs think in tickets, not in "GitHub said X, Jira said Y". So a
+ * commit on branch feature/PROJ-412, the PR that closes PROJ-412, the Jira move
+ * of PROJ-412, and the Slack thread about PROJ-412 all collapse into one group.
+ * Events with no detectable work item land under "Other".
+ */
+export const OTHER_KEY = "__other__";
+export function groupByWorkItem(events) {
+    const map = new Map();
+    for (const e of events) {
+        const key = e.workItem ?? OTHER_KEY;
+        const arr = map.get(key);
+        if (arr)
+            arr.push(e);
+        else
+            map.set(key, [e]);
+    }
+    const groups = [];
+    for (const [key, evs] of map) {
+        evs.sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+        const title = evs.find((e) => e.workItemTitle)?.workItemTitle;
+        const url = evs.find((e) => e.url && e.workItem === key)?.url;
+        const sources = [...new Set(evs.map((e) => e.source))];
+        groups.push({
+            key,
+            title,
+            events: evs,
+            sources,
+            latest: evs[evs.length - 1].timestamp,
+            url,
+        });
+    }
+    // Most recently active first; "Other" always last.
+    groups.sort((a, b) => {
+        if (a.key === OTHER_KEY)
+            return 1;
+        if (b.key === OTHER_KEY)
+            return -1;
+        return Date.parse(b.latest) - Date.parse(a.latest);
+    });
+    return groups;
+}

package/dist/analytics/weekly.js

@@ -0,0 +1,42 @@
+/**
+ * Weekly summary: a week of activity rolled into accomplishments, for 1:1s and
+ * weekly status. Same observed-only rule as the standup; groups work into
+ * Shipped vs In progress vs Reviews & support.
+ */
+import { groupByWorkItem, OTHER_KEY } from "./grouping.js";
+import { heading, plural } from "../format.js";
+import { truncate } from "../normalize.js";
+const DONE_RE = /\b(done|closed|merged|shipped|resolved|complete|deployed)\b/i;
+function isShipped(group) {
+    return group.events.some((e) => e.kind === "pr_merged" ||
+        (e.kind === "issue_moved" && !!e.toStatus && DONE_RE.test(e.toStatus)));
+}
+function line(group) {
+    const label = group.title ? `${group.key} ${group.title}` : group.key;
+    return `- **${truncate(label, 90)}**`;
+}
+export function buildWeeklySummary(events, window, actor, isDemo = false) {
+    const groups = groupByWorkItem(events).filter((g) => g.key !== OTHER_KEY);
+    const shipped = groups.filter(isShipped);
+    const ongoing = groups.filter((g) => !isShipped(g));
+    const reviews = events.filter((e) => e.kind === "pr_reviewed");
+    const commits = events.filter((e) => e.kind === "commit").length;
+    const merged = events.filter((e) => e.kind === "pr_merged").length;
+    const out = [];
+    out.push(heading(1, `Weekly summary: ${actor.displayName}`));
+    out.push(`_${window.label}${isDemo ? ". Demo data." : ""}_`);
+    out.push("");
+    out.push(heading(2, "Shipped"));
+    out.push(shipped.length ? shipped.map(line).join("\n") : "_Nothing closed out this period._");
+    out.push("");
+    out.push(heading(2, "In progress"));
+    out.push(ongoing.length ? ongoing.map(line).join("\n") : "_Nothing open._");
+    if (reviews.length) {
+        out.push("");
+        out.push(heading(2, "Reviews and support"));
+        out.push(`- Reviewed ${plural(reviews.length, "PR")} for teammates`);
+    }
+    out.push("");
+    out.push(`_${plural(groups.length, "work item")} touched, ${plural(merged, "PR")} merged, ${plural(commits, "commit")}._`);
+    return out.join("\n");
+}