@sentry/junior-github 0.159.0 → 0.161.0

package/README.md

@@ -29,3 +29,5 @@ The plugin owns its signed webhook route, deployment, pull request, and release
 resource events, normalized pull request and issue outcome projections, and
 dashboard operational report. Core only owns delivery from plugin-published
 resource events into matching conversation subscriptions.
+
+Person profiles call `hooks.profileReport` for Junior-owned GitHub work attributed through conversation actors.

package/dist/annotations.d.ts

@@ -0,0 +1,3 @@
+import type { ConversationAnnotation, ConversationSidebarAnnotation } from "@sentry/junior-plugin-api";
+/** Select the one GitHub annotation summary shown in a conversation row. */
+export declare function githubSidebarAnnotation(annotations: ConversationAnnotation[]): ConversationSidebarAnnotation | undefined;

package/dist/index.js

@@ -2695,19 +2695,30 @@ async function recordGitHubIssueOutcome(db, input) {
   const outcome = githubIssueOutcomeInputSchema.parse(input);
   const values = projectionValues(outcome);
   if (!outcome.candidateOwned) {
-    await db.update(juniorGitHubIssues).set(values).where(
+    const updated = await db.update(juniorGitHubIssues).set(values).where(
       and(
         eq(juniorGitHubIssues.issueId, outcome.issueId),
         lte(juniorGitHubIssues.updatedAt, outcome.updatedAt)
       )
-    );
-    return;
+    ).returning({
+      conversationIds: juniorGitHubIssues.conversationIds
+    });
+    return {
+      applied: updated.length > 0,
+      conversationIds: updated[0]?.conversationIds ?? []
+    };
   }
-  await db.insert(juniorGitHubIssues).values({ issueId: outcome.issueId, ...values }).onConflictDoUpdate({
+  const inserted = await db.insert(juniorGitHubIssues).values({ issueId: outcome.issueId, ...values }).onConflictDoUpdate({
     target: juniorGitHubIssues.issueId,
     set: values,
     where: lte(juniorGitHubIssues.updatedAt, outcome.updatedAt)
+  }).returning({
+    conversationIds: juniorGitHubIssues.conversationIds
   });
+  return {
+    applied: inserted.length > 0,
+    conversationIds: inserted[0]?.conversationIds ?? []
+  };
 }
 async function recordGitHubIssueConversations(db, input) {
   const association = githubIssueConversationsInputSchema.parse(input);
@@ -3342,7 +3353,23 @@ function createGitHubWebhookRoute(args) {
         }
       }
       if (issueOutcome) {
-        await recordGitHubIssueOutcome(args.db, issueOutcome);
+        const recordedOutcome = await recordGitHubIssueOutcome(
+          args.db,
+          issueOutcome
+        );
+        if (recordedOutcome.applied && issueOutcome.state === "closed") {
+          await Promise.all(
+            recordedOutcome.conversationIds.map(
+              (conversationId) => args.annotations.forConversation(conversationId).upsert({
+                kind: "resource_link",
+                key: `${issueOutcome.repositoryFullName.toLowerCase()}#${issueOutcome.number}`,
+                label: `${issueOutcome.repositoryFullName}#${issueOutcome.number}`,
+                url: `https://github.com/${issueOutcome.repositoryFullName}/issues/${issueOutcome.number}`,
+                status: "closed"
+              })
+            )
+          );
+        }
       }
       const recordedIssueConversations = issueConversations ? await recordGitHubIssueConversations(args.db, issueConversations) : false;
       const recordedPullRequestConversations = pullRequestConversations ? await recordGitHubPullRequestConversations(
@@ -3371,20 +3398,258 @@ function createGitHubWebhookRoute(args) {
   };
 }
 
-// src/outcomes/report.ts
-import { sql as sql5 } from "drizzle-orm";
-import { z as z16 } from "zod";
-
-// src/outcomes/cost.ts
+// src/outcomes/profile-report.ts
 import { sql as sql4 } from "drizzle-orm";
 import { z as z15 } from "zod";
 var DAY_MS = 24 * 60 * 60 * 1e3;
-var costWindowSchema = z15.object({
+var WINDOWS = [7, 30, 90];
+var pullRequestStatsSchema = z15.object({
+  closed: z15.number().int().nonnegative(),
+  created: z15.number().int().nonnegative(),
   days: z15.number().int().positive(),
-  issueCostUsd: z15.number().nonnegative().nullable(),
-  medianIssueCostUsd: z15.number().nonnegative().nullable(),
-  medianPullRequestCostUsd: z15.number().nonnegative().nullable(),
-  pullRequestCostUsd: z15.number().nonnegative().nullable()
+  merged: z15.number().int().nonnegative()
+}).strict().transform((row) => {
+  const terminal = row.merged + row.closed;
+  return {
+    ...row,
+    mergeRate: terminal > 0 ? row.merged / terminal : void 0
+  };
+});
+var issueStatsSchema = z15.object({
+  created: z15.number().int().nonnegative(),
+  days: z15.number().int().positive()
+}).strict();
+var daySchema = z15.object({
+  created: z15.number().int().nonnegative(),
+  date: z15.string().date()
+}).strict();
+function queryRows(result) {
+  if (typeof result !== "object" || result === null || !("rows" in result) || !Array.isArray(result.rows)) {
+    throw new TypeError("GitHub profile report query did not return rows");
+  }
+  return result.rows;
+}
+function ownedByUserSql(conversationIds, userId) {
+  return sql4`EXISTS (
+    SELECT 1
+    FROM unnest(${conversationIds}) AS linked(conversation_id)
+    INNER JOIN junior_conversations AS conversations
+      ON conversations.conversation_id = linked.conversation_id
+    INNER JOIN junior_identities AS identities
+      ON identities.id = conversations.actor_identity_id
+    WHERE identities.user_id = ${userId}
+  )`;
+}
+function formatPercent(value) {
+  return value === void 0 ? "\u2014" : `${Math.round(value * 100)}%`;
+}
+function startOfUtcDay(timestampMs) {
+  const date = new Date(timestampMs);
+  date.setUTCHours(0, 0, 0, 0);
+  return date;
+}
+async function aggregatePullRequestWindows(args) {
+  const starts = WINDOWS.map(
+    (days) => [days, new Date(args.nowMs - days * DAY_MS)]
+  );
+  const oldestStart = starts.at(-1)[1];
+  const table = juniorGitHubPullRequests;
+  const owned = ownedByUserSql(sql4`${table.conversationIds}`, args.userId);
+  const result = await args.db.execute(sql4`
+    WITH windows(days, start_at) AS (
+      VALUES
+        (${starts[0][0]}::integer, ${starts[0][1]}::timestamptz),
+        (${starts[1][0]}::integer, ${starts[1][1]}::timestamptz),
+        (${starts[2][0]}::integer, ${starts[2][1]}::timestamptz)
+    ), recent_pull_requests AS MATERIALIZED (
+      SELECT
+        ${table.pullRequestId},
+        ${table.state},
+        ${table.openedAt},
+        ${table.mergedAt},
+        ${table.closedAt}
+      FROM ${table}
+      WHERE (${table.openedAt} >= ${oldestStart}
+        OR ${table.mergedAt} >= ${oldestStart}
+        OR ${table.closedAt} >= ${oldestStart})
+        AND ${owned}
+    )
+    SELECT
+      windows.days AS "days",
+      count(recent_pull_requests.pull_request_id)
+        FILTER (WHERE recent_pull_requests.opened_at >= windows.start_at)::integer
+        AS "created",
+      count(recent_pull_requests.pull_request_id)
+        FILTER (
+          WHERE recent_pull_requests.state = 'merged'
+            AND recent_pull_requests.merged_at >= windows.start_at
+        )::integer AS "merged",
+      count(recent_pull_requests.pull_request_id)
+        FILTER (
+          WHERE recent_pull_requests.state = 'closed_unmerged'
+            AND recent_pull_requests.closed_at >= windows.start_at
+        )::integer AS "closed"
+    FROM windows
+    LEFT JOIN recent_pull_requests ON true
+    GROUP BY windows.days
+    ORDER BY windows.days
+  `);
+  return z15.array(pullRequestStatsSchema).parse(queryRows(result));
+}
+async function aggregateIssueWindows(args) {
+  const starts = WINDOWS.map(
+    (days) => [days, new Date(args.nowMs - days * DAY_MS)]
+  );
+  const oldestStart = starts.at(-1)[1];
+  const table = juniorGitHubIssues;
+  const owned = ownedByUserSql(sql4`${table.conversationIds}`, args.userId);
+  const result = await args.db.execute(sql4`
+    WITH windows(days, start_at) AS (
+      VALUES
+        (${starts[0][0]}::integer, ${starts[0][1]}::timestamptz),
+        (${starts[1][0]}::integer, ${starts[1][1]}::timestamptz),
+        (${starts[2][0]}::integer, ${starts[2][1]}::timestamptz)
+    ), recent_issues AS MATERIALIZED (
+      SELECT
+        ${table.issueId},
+        ${table.openedAt}
+      FROM ${table}
+      WHERE ${table.openedAt} >= ${oldestStart}
+        AND ${owned}
+    )
+    SELECT
+      windows.days AS "days",
+      count(recent_issues.issue_id)
+        FILTER (WHERE recent_issues.opened_at >= windows.start_at)::integer
+        AS "created"
+    FROM windows
+    LEFT JOIN recent_issues ON true
+    GROUP BY windows.days
+    ORDER BY windows.days
+  `);
+  return z15.array(issueStatsSchema).parse(queryRows(result));
+}
+async function aggregateOpenedDays(args) {
+  const end = new Date(args.nowMs);
+  const start = startOfUtcDay(args.nowMs - (WINDOWS.at(-1) - 1) * DAY_MS);
+  const table = args.table;
+  const owned = ownedByUserSql(sql4`${table.conversationIds}`, args.userId);
+  const result = await args.db.execute(sql4`
+    WITH days AS (
+      SELECT generate_series(
+        date_trunc('day', ${start}::timestamptz AT TIME ZONE 'UTC'),
+        date_trunc('day', ${end}::timestamptz AT TIME ZONE 'UTC'),
+        interval '1 day'
+      ) AS day
+    ), daily AS (
+      SELECT
+        date_trunc('day', ${table.openedAt} AT TIME ZONE 'UTC') AS day,
+        count(*)::integer AS created
+      FROM ${table}
+      WHERE ${table.openedAt} >= ${start}
+        AND ${owned}
+      GROUP BY date_trunc('day', ${table.openedAt} AT TIME ZONE 'UTC')
+    )
+    SELECT
+      to_char(days.day, 'YYYY-MM-DD') AS "date",
+      coalesce(daily.created, 0)::integer AS "created"
+    FROM days
+    LEFT JOIN daily ON daily.day = days.day
+    ORDER BY days.day
+  `);
+  return z15.array(daySchema).parse(queryRows(result));
+}
+async function buildGitHubProfileReport(args) {
+  const [windows, pullRequestDays, issueWindows, issueDays] = await Promise.all(
+    [
+      aggregatePullRequestWindows(args),
+      aggregateOpenedDays({
+        db: args.db,
+        nowMs: args.nowMs,
+        table: juniorGitHubPullRequests,
+        userId: args.userId
+      }),
+      aggregateIssueWindows(args),
+      aggregateOpenedDays({
+        db: args.db,
+        nowMs: args.nowMs,
+        table: juniorGitHubIssues,
+        userId: args.userId
+      })
+    ]
+  );
+  const thirtyDays = windows.find((window) => window.days === 30);
+  const issueThirtyDays = issueWindows.find((window) => window.days === 30);
+  const hasActivity = windows.some((window) => window.created + window.merged + window.closed > 0) || issueWindows.some((window) => window.created > 0);
+  if (!hasActivity) {
+    return void 0;
+  }
+  return {
+    generatedAt: new Date(args.nowMs).toISOString(),
+    title: "GitHub",
+    metrics: [
+      {
+        label: "PRs opened \xB7 30d",
+        value: String(thirtyDays.created)
+      },
+      {
+        label: "PRs merged \xB7 30d",
+        value: String(thirtyDays.merged)
+      },
+      {
+        label: "Issues opened \xB7 30d",
+        value: String(issueThirtyDays.created)
+      },
+      {
+        label: "PR merge rate \xB7 30d",
+        value: formatPercent(thirtyDays.mergeRate)
+      }
+    ],
+    widgets: [
+      {
+        id: "pull-requests-created",
+        type: "bar_chart",
+        title: "Pull requests opened",
+        description: "Junior-owned pull requests opened for this person per day",
+        timeRangeDays: [...WINDOWS],
+        series: [{ key: "created", label: "Opened" }],
+        categories: pullRequestDays.map((stats) => ({
+          id: stats.date,
+          label: stats.date,
+          values: { created: stats.created }
+        }))
+      },
+      {
+        id: "issues-created",
+        type: "bar_chart",
+        title: "Issues opened",
+        description: "Junior-owned issues opened for this person per day",
+        timeRangeDays: [...WINDOWS],
+        series: [{ key: "created", label: "Opened" }],
+        categories: issueDays.map((stats) => ({
+          id: stats.date,
+          label: stats.date,
+          values: { created: stats.created }
+        }))
+      }
+    ]
+  };
+}
+
+// src/outcomes/report.ts
+import { sql as sql6 } from "drizzle-orm";
+import { z as z17 } from "zod";
+
+// src/outcomes/cost.ts
+import { sql as sql5 } from "drizzle-orm";
+import { z as z16 } from "zod";
+var DAY_MS2 = 24 * 60 * 60 * 1e3;
+var costWindowSchema = z16.object({
+  days: z16.number().int().positive(),
+  issueCostUsd: z16.number().nonnegative().nullable(),
+  medianIssueCostUsd: z16.number().nonnegative().nullable(),
+  medianPullRequestCostUsd: z16.number().nonnegative().nullable(),
+  pullRequestCostUsd: z16.number().nonnegative().nullable()
 }).strict().transform((row) => ({
   days: row.days,
   issueCostUsd: row.issueCostUsd ?? void 0,
@@ -3392,12 +3657,12 @@ var costWindowSchema = z15.object({
   medianPullRequestCostUsd: row.medianPullRequestCostUsd ?? void 0,
   pullRequestCostUsd: row.pullRequestCostUsd ?? void 0
 }));
-var repositoryCostSchema = z15.object({
-  issueCostUsd: z15.number().nonnegative().nullable(),
-  medianIssueCostUsd: z15.number().nonnegative().nullable(),
-  medianPullRequestCostUsd: z15.number().nonnegative().nullable(),
-  pullRequestCostUsd: z15.number().nonnegative().nullable(),
-  repository: z15.string().min(1)
+var repositoryCostSchema = z16.object({
+  issueCostUsd: z16.number().nonnegative().nullable(),
+  medianIssueCostUsd: z16.number().nonnegative().nullable(),
+  medianPullRequestCostUsd: z16.number().nonnegative().nullable(),
+  pullRequestCostUsd: z16.number().nonnegative().nullable(),
+  repository: z16.string().min(1)
 }).strict().transform((row) => ({
   issueCostUsd: row.issueCostUsd ?? void 0,
   medianIssueCostUsd: row.medianIssueCostUsd ?? void 0,
@@ -3405,17 +3670,17 @@ var repositoryCostSchema = z15.object({
   pullRequestCostUsd: row.pullRequestCostUsd ?? void 0,
   repository: row.repository
 }));
-function queryRows(result) {
+function queryRows2(result) {
   if (typeof result !== "object" || result === null || !("rows" in result) || !Array.isArray(result.rows)) {
     throw new TypeError("GitHub cost query did not return rows");
   }
   return result.rows;
 }
 async function hasConversationUsageTable(db) {
-  const result = await db.execute(sql4`
+  const result = await db.execute(sql5`
     SELECT to_regclass('public.junior_conversations') IS NOT NULL AS "present"
   `);
-  const row = queryRows(result)[0];
+  const row = queryRows2(result)[0];
   return typeof row === "object" && row !== null && "present" in row && row.present === true;
 }
 function emptyCostWindows(windows) {
@@ -3428,7 +3693,7 @@ function emptyCostWindows(windows) {
   }));
 }
 function conversationTreeCostExpr() {
-  return sql4`
+  return sql5`
     coalesce((
       SELECT sum(
         CASE
@@ -3459,7 +3724,7 @@ function conversationTreeCostExpr() {
 function pullRequestConversationIdsExpr() {
   const pullRequests = juniorGitHubPullRequests;
   const issues = juniorGitHubIssues;
-  return sql4`
+  return sql5`
     ARRAY(
       SELECT DISTINCT unnest(
         ${pullRequests.conversationIds}
@@ -3481,7 +3746,7 @@ function pullRequestConversationIdsExpr() {
 function issueConversationIdsExpr() {
   const pullRequests = juniorGitHubPullRequests;
   const issues = juniorGitHubIssues;
-  return sql4`
+  return sql5`
     ARRAY(
       SELECT DISTINCT unnest(
         ${issues.conversationIds}
@@ -3505,21 +3770,21 @@ async function aggregateGitHubCostWindows(args) {
     return emptyCostWindows(args.windows);
   }
   const starts = args.windows.map(
-    (days) => [days, new Date(args.nowMs - days * DAY_MS)]
+    (days) => [days, new Date(args.nowMs - days * DAY_MS2)]
   );
   const oldestStart = starts.at(-1)[1];
   const pullRequests = juniorGitHubPullRequests;
   const issues = juniorGitHubIssues;
-  const windowValues = sql4.join(
+  const windowValues = sql5.join(
     starts.map(
-      ([days, start]) => sql4`(${days}::integer, ${start}::timestamptz)`
+      ([days, start]) => sql5`(${days}::integer, ${start}::timestamptz)`
     ),
-    sql4`, `
+    sql5`, `
   );
   const conversationTreeCost = conversationTreeCostExpr();
   const pullRequestConversationIds = pullRequestConversationIdsExpr();
   const issueConversationIds = issueConversationIdsExpr();
-  const result = await args.db.execute(sql4`
+  const result = await args.db.execute(sql5`
     WITH windows(days, start_at) AS (
       VALUES ${windowValues}
     ), pull_request_entities AS (
@@ -3602,19 +3867,19 @@ async function aggregateGitHubCostWindows(args) {
     INNER JOIN issue_window ON issue_window.days = pull_request_window.days
     ORDER BY pull_request_window.days
   `);
-  return z15.array(costWindowSchema).parse(queryRows(result));
+  return z16.array(costWindowSchema).parse(queryRows2(result));
 }
 async function aggregateGitHubRepositoryCosts(args) {
   if (!await hasConversationUsageTable(args.db)) {
     return [];
   }
-  const start = new Date(args.nowMs - 30 * DAY_MS);
+  const start = new Date(args.nowMs - 30 * DAY_MS2);
   const pullRequests = juniorGitHubPullRequests;
   const issues = juniorGitHubIssues;
   const conversationTreeCost = conversationTreeCostExpr();
   const pullRequestConversationIds = pullRequestConversationIdsExpr();
   const issueConversationIds = issueConversationIdsExpr();
-  const result = await args.db.execute(sql4`
+  const result = await args.db.execute(sql5`
     WITH pull_request_entities AS (
       SELECT
         ${pullRequests.repositoryFullName} AS repository,
@@ -3700,7 +3965,7 @@ async function aggregateGitHubRepositoryCosts(args) {
       ON issue_totals.repository = repositories.repository
     ORDER BY "repository" ASC
   `);
-  return z15.array(repositoryCostSchema).parse(queryRows(result));
+  return z16.array(repositoryCostSchema).parse(queryRows2(result));
 }
 function formatCostUsd(value) {
   if (value === void 0) return "\u2014";
@@ -3713,14 +3978,14 @@ function formatCostUsd(value) {
 }
 
 // src/outcomes/report.ts
-var DAY_MS2 = 24 * 60 * 60 * 1e3;
-var WINDOWS = [7, 30, 90];
-var pullRequestStatsSchema = z16.object({
-  closed: z16.number().int().nonnegative(),
-  created: z16.number().int().nonnegative(),
-  days: z16.number().int().positive(),
-  medianMergeTimeMs: z16.number().nonnegative().nullable(),
-  merged: z16.number().int().nonnegative()
+var DAY_MS3 = 24 * 60 * 60 * 1e3;
+var WINDOWS2 = [7, 30, 90];
+var pullRequestStatsSchema2 = z17.object({
+  closed: z17.number().int().nonnegative(),
+  created: z17.number().int().nonnegative(),
+  days: z17.number().int().positive(),
+  medianMergeTimeMs: z17.number().nonnegative().nullable(),
+  merged: z17.number().int().nonnegative()
 }).strict().transform((row) => {
   const terminal = row.merged + row.closed;
   return {
@@ -3729,12 +3994,12 @@ var pullRequestStatsSchema = z16.object({
     mergeRate: terminal > 0 ? row.merged / terminal : void 0
   };
 });
-var pullRequestRepositoryStatsSchema = z16.object({
-  closed: z16.number().int().nonnegative(),
-  created: z16.number().int().nonnegative(),
-  juniorOnly: z16.number().int().nonnegative(),
-  merged: z16.number().int().nonnegative(),
-  repository: z16.string().min(1)
+var pullRequestRepositoryStatsSchema = z17.object({
+  closed: z17.number().int().nonnegative(),
+  created: z17.number().int().nonnegative(),
+  juniorOnly: z17.number().int().nonnegative(),
+  merged: z17.number().int().nonnegative(),
+  repository: z17.string().min(1)
 }).strict().transform((row) => {
   const terminal = row.merged + row.closed;
   return {
@@ -3742,47 +4007,47 @@ var pullRequestRepositoryStatsSchema = z16.object({
     mergeRate: terminal > 0 ? row.merged / terminal : void 0
   };
 });
-var issueStatsSchema = z16.object({
-  closedCompleted: z16.number().int().nonnegative(),
-  closedDuplicate: z16.number().int().nonnegative(),
-  closedNotPlanned: z16.number().int().nonnegative(),
-  closedUnknown: z16.number().int().nonnegative(),
-  created: z16.number().int().nonnegative(),
-  days: z16.number().int().positive(),
-  medianCloseTimeMs: z16.number().nonnegative().nullable()
+var issueStatsSchema2 = z17.object({
+  closedCompleted: z17.number().int().nonnegative(),
+  closedDuplicate: z17.number().int().nonnegative(),
+  closedNotPlanned: z17.number().int().nonnegative(),
+  closedUnknown: z17.number().int().nonnegative(),
+  created: z17.number().int().nonnegative(),
+  days: z17.number().int().positive(),
+  medianCloseTimeMs: z17.number().nonnegative().nullable()
 }).strict().transform((row) => ({
   ...row,
   medianCloseTimeMs: row.medianCloseTimeMs ?? void 0
 }));
-var pullRequestDaySchema = z16.object({
-  created: z16.number().int().nonnegative(),
-  date: z16.string().date()
+var pullRequestDaySchema = z17.object({
+  created: z17.number().int().nonnegative(),
+  date: z17.string().date()
 }).strict();
-var issueDaySchema = z16.object({
-  created: z16.number().int().nonnegative(),
-  date: z16.string().date()
+var issueDaySchema = z17.object({
+  created: z17.number().int().nonnegative(),
+  date: z17.string().date()
 }).strict();
-var issueRepositoryStatsSchema = z16.object({
-  closedCompleted: z16.number().int().nonnegative(),
-  closedDuplicate: z16.number().int().nonnegative(),
-  closedNotPlanned: z16.number().int().nonnegative(),
-  closedUnknown: z16.number().int().nonnegative(),
-  created: z16.number().int().nonnegative(),
-  repository: z16.string().min(1)
+var issueRepositoryStatsSchema = z17.object({
+  closedCompleted: z17.number().int().nonnegative(),
+  closedDuplicate: z17.number().int().nonnegative(),
+  closedNotPlanned: z17.number().int().nonnegative(),
+  closedUnknown: z17.number().int().nonnegative(),
+  created: z17.number().int().nonnegative(),
+  repository: z17.string().min(1)
 }).strict();
-function queryRows2(result) {
+function queryRows3(result) {
   if (typeof result !== "object" || result === null || !("rows" in result) || !Array.isArray(result.rows)) {
     throw new TypeError("GitHub outcome query did not return rows");
   }
   return result.rows;
 }
-async function aggregatePullRequestWindows(args) {
-  const starts = WINDOWS.map(
-    (days) => [days, new Date(args.nowMs - days * DAY_MS2)]
+async function aggregatePullRequestWindows2(args) {
+  const starts = WINDOWS2.map(
+    (days) => [days, new Date(args.nowMs - days * DAY_MS3)]
   );
   const oldestStart = starts.at(-1)[1];
   const table = juniorGitHubPullRequests;
-  const result = await args.db.execute(sql5`
+  const result = await args.db.execute(sql6`
     WITH windows(days, start_at) AS (
       VALUES
         (${starts[0][0]}::integer, ${starts[0][1]}::timestamptz),
@@ -3832,13 +4097,13 @@ async function aggregatePullRequestWindows(args) {
     GROUP BY windows.days
     ORDER BY windows.days
   `);
-  return z16.array(pullRequestStatsSchema).parse(queryRows2(result));
+  return z17.array(pullRequestStatsSchema2).parse(queryRows3(result));
 }
 async function aggregatePullRequestDays(args) {
   const end = new Date(args.nowMs);
-  const start = startOfUtcDay(args.nowMs - (WINDOWS.at(-1) - 1) * DAY_MS2);
+  const start = startOfUtcDay2(args.nowMs - (WINDOWS2.at(-1) - 1) * DAY_MS3);
   const table = juniorGitHubPullRequests;
-  const result = await args.db.execute(sql5`
+  const result = await args.db.execute(sql6`
     WITH days AS (
       SELECT generate_series(
         date_trunc('day', ${start}::timestamptz AT TIME ZONE 'UTC'),
@@ -3860,12 +4125,12 @@ async function aggregatePullRequestDays(args) {
     LEFT JOIN daily ON daily.day = days.day
     ORDER BY days.day
   `);
-  return z16.array(pullRequestDaySchema).parse(queryRows2(result));
+  return z17.array(pullRequestDaySchema).parse(queryRows3(result));
 }
 async function aggregatePullRequestRepositories(args) {
-  const start = new Date(args.nowMs - 30 * DAY_MS2);
+  const start = new Date(args.nowMs - 30 * DAY_MS3);
   const table = juniorGitHubPullRequests;
-  const result = await args.db.execute(sql5`
+  const result = await args.db.execute(sql6`
     SELECT
       ${table.repositoryFullName} AS "repository",
       count(*) FILTER (WHERE ${table.openedAt} >= ${start})::integer
@@ -3890,15 +4155,15 @@ async function aggregatePullRequestRepositories(args) {
     ORDER BY "merged" DESC, "created" DESC, "repository" ASC
     LIMIT 25
   `);
-  return z16.array(pullRequestRepositoryStatsSchema).parse(queryRows2(result));
+  return z17.array(pullRequestRepositoryStatsSchema).parse(queryRows3(result));
 }
-async function aggregateIssueWindows(args) {
-  const starts = WINDOWS.map(
-    (days) => [days, new Date(args.nowMs - days * DAY_MS2)]
+async function aggregateIssueWindows2(args) {
+  const starts = WINDOWS2.map(
+    (days) => [days, new Date(args.nowMs - days * DAY_MS3)]
   );
   const oldestStart = starts.at(-1)[1];
   const table = juniorGitHubIssues;
-  const result = await args.db.execute(sql5`
+  const result = await args.db.execute(sql6`
     WITH windows(days, start_at) AS (
       VALUES
         (${starts[0][0]}::integer, ${starts[0][1]}::timestamptz),
@@ -3959,13 +4224,13 @@ async function aggregateIssueWindows(args) {
     GROUP BY windows.days
     ORDER BY windows.days
   `);
-  return z16.array(issueStatsSchema).parse(queryRows2(result));
+  return z17.array(issueStatsSchema2).parse(queryRows3(result));
 }
 async function aggregateIssueDays(args) {
   const end = new Date(args.nowMs);
-  const start = startOfUtcDay(args.nowMs - (WINDOWS.at(-1) - 1) * DAY_MS2);
+  const start = startOfUtcDay2(args.nowMs - (WINDOWS2.at(-1) - 1) * DAY_MS3);
   const table = juniorGitHubIssues;
-  const result = await args.db.execute(sql5`
+  const result = await args.db.execute(sql6`
     WITH days AS (
       SELECT generate_series(
         date_trunc('day', ${start}::timestamptz AT TIME ZONE 'UTC'),
@@ -3987,12 +4252,12 @@ async function aggregateIssueDays(args) {
     LEFT JOIN daily ON daily.day = days.day
     ORDER BY days.day
   `);
-  return z16.array(issueDaySchema).parse(queryRows2(result));
+  return z17.array(issueDaySchema).parse(queryRows3(result));
 }
 async function aggregateIssueRepositories(args) {
-  const start = new Date(args.nowMs - 30 * DAY_MS2);
+  const start = new Date(args.nowMs - 30 * DAY_MS3);
   const table = juniorGitHubIssues;
-  const result = await args.db.execute(sql5`
+  const result = await args.db.execute(sql6`
     SELECT
       ${table.repositoryFullName} AS "repository",
       count(*) FILTER (WHERE ${table.openedAt} >= ${start})::integer
@@ -4024,9 +4289,9 @@ async function aggregateIssueRepositories(args) {
     ORDER BY "created" DESC, "closedCompleted" DESC, "repository" ASC
     LIMIT 25
   `);
-  return z16.array(issueRepositoryStatsSchema).parse(queryRows2(result));
+  return z17.array(issueRepositoryStatsSchema).parse(queryRows3(result));
 }
-function formatPercent(value) {
+function formatPercent2(value) {
   return value === void 0 ? "\u2014" : `${Math.round(value * 100)}%`;
 }
 function formatDuration(value) {
@@ -4036,7 +4301,7 @@ function formatDuration(value) {
   if (hours < 24) return `${Math.round(hours * 10) / 10}h`;
   return `${Math.round(hours / 24 * 10) / 10}d`;
 }
-function startOfUtcDay(timestampMs) {
+function startOfUtcDay2(timestampMs) {
   const date = new Date(timestampMs);
   date.setUTCHours(0, 0, 0, 0);
   return date;
@@ -4052,13 +4317,13 @@ async function buildGitHubOutcomeReport(args) {
     costWindows,
     repositoryCosts
   ] = await Promise.all([
-    aggregatePullRequestWindows(args),
+    aggregatePullRequestWindows2(args),
     aggregatePullRequestDays(args),
     aggregatePullRequestRepositories(args),
-    aggregateIssueWindows(args),
+    aggregateIssueWindows2(args),
     aggregateIssueDays(args),
     aggregateIssueRepositories(args),
-    aggregateGitHubCostWindows({ ...args, windows: WINDOWS }),
+    aggregateGitHubCostWindows({ ...args, windows: WINDOWS2 }),
     aggregateGitHubRepositoryCosts(args)
   ]);
   const thirtyDays = windows.find((window) => window.days === 30);
@@ -4073,7 +4338,7 @@ async function buildGitHubOutcomeReport(args) {
     metrics: [
       {
         label: "PR closure merge rate \xB7 30d",
-        value: formatPercent(thirtyDays.mergeRate)
+        value: formatPercent2(thirtyDays.mergeRate)
       },
       {
         label: "Median PR merge time \xB7 merged in 30d",
@@ -4106,7 +4371,7 @@ async function buildGitHubOutcomeReport(args) {
         type: "bar_chart",
         title: "Pull requests created",
         description: "Junior-owned pull requests opened per day",
-        timeRangeDays: [...WINDOWS],
+        timeRangeDays: [...WINDOWS2],
         series: [{ key: "created", label: "Created" }],
         categories: pullRequestDays.map((stats) => ({
           id: stats.date,
@@ -4119,7 +4384,7 @@ async function buildGitHubOutcomeReport(args) {
         type: "bar_chart",
         title: "Issues created",
         description: "Junior-owned issues opened per day",
-        timeRangeDays: [...WINDOWS],
+        timeRangeDays: [...WINDOWS2],
         series: [{ key: "created", label: "Created" }],
         categories: issueDays.map((stats) => ({
           id: stats.date,
@@ -4149,7 +4414,7 @@ async function buildGitHubOutcomeReport(args) {
             merged: String(stats.merged),
             closed: String(stats.closed),
             juniorOnly: String(stats.juniorOnly),
-            mergeRate: formatPercent(stats.mergeRate),
+            mergeRate: formatPercent2(stats.mergeRate),
             medianCost: formatCostUsd(
               repositoryCostByName.get(repository)?.medianPullRequestCostUsd
             )
@@ -4188,18 +4453,18 @@ async function buildGitHubOutcomeReport(args) {
 }
 
 // src/pull-request-outcomes/commit-composition.ts
-import { z as z17 } from "zod";
-var canonicalCommitSchema = z17.object({
-  authorEmail: z17.string().nullable(),
-  authorLogin: z17.string().nullable()
+import { z as z18 } from "zod";
+var canonicalCommitSchema = z18.object({
+  authorEmail: z18.string().nullable(),
+  authorLogin: z18.string().nullable()
 }).strict();
-var providerCommitSchema = z17.object({
-  author: z17.object({ login: z17.string() }).passthrough().nullable(),
-  commit: z17.object({
-    author: z17.object({ email: z17.string() }).passthrough().nullable()
+var providerCommitSchema = z18.object({
+  author: z18.object({ login: z18.string() }).passthrough().nullable(),
+  commit: z18.object({
+    author: z18.object({ email: z18.string() }).passthrough().nullable()
   }).passthrough()
 }).passthrough();
-var commitPageSchema = z17.array(providerCommitSchema).transform(
+var commitPageSchema = z18.array(providerCommitSchema).transform(
   (commits) => commits.map(
     (commit) => canonicalCommitSchema.parse({
       authorEmail: commit.commit.author?.email ?? null,
@@ -4240,6 +4505,48 @@ async function classifyGitHubPullRequestCommitComposition(args) {
   return foundCommit ? "junior_only" : void 0;
 }
 
+// src/annotations.ts
+var STATUS_RANK = {
+  warning: 5,
+  open: 4,
+  draft: 3,
+  merged: 2,
+  closed: 1
+};
+var STATUS_ICON = {
+  warning: "triangle-alert",
+  open: "circle-dot",
+  draft: "circle-dashed",
+  merged: "git-merge",
+  closed: "circle-x"
+};
+function repositoryScope(annotation) {
+  try {
+    const [, owner, repo] = new URL(annotation.url).pathname.split("/");
+    return owner && repo ? { key: `${owner}/${repo}`, label: repo } : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function githubSidebarAnnotation(annotations) {
+  const links = annotations.flatMap((annotation) => {
+    const repo = repositoryScope(annotation);
+    const status2 = annotation.status;
+    return repo && status2 ? [{ repo, status: status2 }] : [];
+  });
+  if (links.length === 0) return void 0;
+  const repos = new Map(links.map((link) => [link.repo.key, link.repo.label]));
+  const status = links.reduce(
+    (current, link) => STATUS_RANK[link.status] > STATUS_RANK[current] ? link.status : current,
+    "closed"
+  );
+  return {
+    icon: STATUS_ICON[status],
+    key: "github",
+    label: repos.size === 1 ? [...repos.values()][0] : `${repos.size} repos`
+  };
+}
+
 // src/webhooks/check-suite-enrichment.ts
 function checkRunsFromResponse(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -4487,6 +4794,121 @@ async function configureGit(ctx, key, value) {
   }
 }
 
+// src/reply-markdown.ts
+var GITHUB_OWNER_PATTERN = "[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?";
+var GITHUB_REPOSITORY_PATTERN = "[A-Za-z0-9._-]+";
+var GITHUB_ISSUE_REFERENCE_PATTERN = new RegExp(
+  `^(${GITHUB_OWNER_PATTERN})\\/(${GITHUB_REPOSITORY_PATTERN})#(\\d+)\\b`
+);
+function isReferenceBoundary(char) {
+  return char === void 0 || !/[A-Za-z0-9._-]/.test(char);
+}
+function readInlineCode(text2, start) {
+  if (text2[start] !== "`") {
+    return void 0;
+  }
+  let markerLength = 1;
+  while (text2[start + markerLength] === "`") {
+    markerLength++;
+  }
+  const marker = "`".repeat(markerLength);
+  const end = text2.indexOf(marker, start + markerLength);
+  return end === -1 ? void 0 : end + markerLength;
+}
+function readFenceLength(line) {
+  const trimmed = line.trimStart();
+  if (!trimmed.startsWith("```")) {
+    return void 0;
+  }
+  let length = 0;
+  while (trimmed[length] === "`") {
+    length++;
+  }
+  return length >= 3 ? length : void 0;
+}
+function readMarkdownLink(text2, start) {
+  if (text2[start] !== "[") {
+    return void 0;
+  }
+  const labelEnd = text2.indexOf("](", start + 1);
+  if (labelEnd === -1) {
+    return void 0;
+  }
+  const label = text2.slice(start + 1, labelEnd);
+  if (label.includes("[") || label.includes("]") || label.includes("\n")) {
+    return void 0;
+  }
+  const destStart = labelEnd + 2;
+  const closeParens = text2.indexOf(")", destStart);
+  return closeParens === -1 ? void 0 : closeParens + 1;
+}
+function readAngleToken(text2, start) {
+  if (text2[start] !== "<") {
+    return void 0;
+  }
+  const end = text2.indexOf(">", start + 1);
+  return end === -1 ? void 0 : end + 1;
+}
+function linkifyLine(line) {
+  let output = "";
+  let index2 = 0;
+  while (index2 < line.length) {
+    const codeEnd = readInlineCode(line, index2);
+    if (codeEnd !== void 0) {
+      output += line.slice(index2, codeEnd);
+      index2 = codeEnd;
+      continue;
+    }
+    const markdownLinkEnd = readMarkdownLink(line, index2);
+    if (markdownLinkEnd !== void 0) {
+      output += line.slice(index2, markdownLinkEnd);
+      index2 = markdownLinkEnd;
+      continue;
+    }
+    const angleTokenEnd = readAngleToken(line, index2);
+    if (angleTokenEnd !== void 0) {
+      output += line.slice(index2, angleTokenEnd);
+      index2 = angleTokenEnd;
+      continue;
+    }
+    if (line.startsWith("https://", index2) || line.startsWith("http://", index2)) {
+      const match = /^https?:\/\/\S+/.exec(line.slice(index2));
+      if (match) {
+        output += match[0];
+        index2 += match[0].length;
+        continue;
+      }
+    }
+    if (isReferenceBoundary(index2 === 0 ? void 0 : line[index2 - 1])) {
+      const match = GITHUB_ISSUE_REFERENCE_PATTERN.exec(line.slice(index2));
+      if (match) {
+        const [reference, owner, repository, number] = match;
+        output += `[${reference}](https://github.com/${owner}/${repository}/issues/${number})`;
+        index2 += reference.length;
+        continue;
+      }
+    }
+    output += line[index2];
+    index2++;
+  }
+  return output;
+}
+function linkifyGitHubReferences(text2) {
+  let openFenceLength = 0;
+  return text2.split("\n").map((line) => {
+    const fenceLength = readFenceLength(line);
+    if (fenceLength !== void 0) {
+      if (openFenceLength === 0) {
+        openFenceLength = fenceLength;
+      } else if (fenceLength >= openFenceLength) {
+        openFenceLength = 0;
+      }
+      return line;
+    }
+    return openFenceLength > 0 ? line : linkifyLine(line);
+  }).join("\n");
+}
+
 // src/plugin.ts
 function githubSmartHttpAccess(upstreamUrl) {
   const pathname = upstreamUrl.pathname.toLowerCase();
@@ -4935,6 +5357,21 @@ function githubPlugin(options = {}) {
       ]
     },
     hooks: {
+      conversationSidebar(ctx) {
+        return {
+          annotationsByConversationId: Object.fromEntries(
+            ctx.conversationIds.flatMap((conversationId) => {
+              const annotation = githubSidebarAnnotation(
+                ctx.annotationsByConversationId[conversationId] ?? []
+              );
+              return annotation ? [[conversationId, [annotation]]] : [];
+            })
+          )
+        };
+      },
+      formatMarkdown({ text: text2 }) {
+        return linkifyGitHubReferences(text2);
+      },
       async unfinishedWork(ctx) {
         const db = ctx.db;
         const [
@@ -5004,6 +5441,13 @@ function githubPlugin(options = {}) {
           nowMs: ctx.nowMs
         });
       },
+      async profileReport(ctx) {
+        return await buildGitHubProfileReport({
+          db: ctx.db,
+          nowMs: ctx.nowMs,
+          userId: ctx.subject.id
+        });
+      },
       tools(ctx) {
         return createGitHubTools(ctx);
       },

package/dist/issue-outcomes/store.d.ts

@@ -30,8 +30,13 @@ export type GitHubIssueConversationsInput = z.output<typeof githubIssueConversat
  * Record the newest lifecycle projection for one Junior-owned issue.
  * Ownership-qualified opening or closing events insert; later events update
  * existing rows, and older provider timestamps cannot regress them.
+ * Returns the written row state so follow-up annotation updates stay scoped to
+ * associated conversations.
  */
-export declare function recordGitHubIssueOutcome(db: GitHubDb, input: GitHubIssueOutcomeInput): Promise<void>;
+export declare function recordGitHubIssueOutcome(db: GitHubDb, input: GitHubIssueOutcomeInput): Promise<{
+    applied: boolean;
+    conversationIds: string[];
+}>;
 /** Append native conversation ids to an existing Junior-owned issue projection. */
 export declare function recordGitHubIssueConversations(db: GitHubDb, input: GitHubIssueConversationsInput): Promise<boolean>;
 export {};

package/dist/outcomes/profile-report.d.ts

@@ -0,0 +1,11 @@
+import type { PluginOperationalReportContent } from "@sentry/junior-plugin-api";
+import type { GitHubDb } from "../db/database.js";
+/**
+ * Build one person-scoped GitHub report for Junior-owned work linked to the
+ * subject's conversations.
+ */
+export declare function buildGitHubProfileReport(args: {
+    db: GitHubDb;
+    nowMs: number;
+    userId: string;
+}): Promise<PluginOperationalReportContent | undefined>;

package/dist/reply-markdown.d.ts

@@ -0,0 +1,2 @@
+/** Linkify GitHub issue and pull request shorthand outside Markdown code. */
+export declare function linkifyGitHubReferences(text: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-github",
-  "version": "0.159.0",
+  "version": "0.161.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -31,7 +31,7 @@
     "@sinclair/typebox": "^0.34.49",
     "drizzle-orm": "^0.45.2",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.159.0"
+    "@sentry/junior-plugin-api": "0.161.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

package/skills/github-code/SKILL.md

@@ -81,5 +81,3 @@ If PR creation or update is blocked, report the exact failed command/tool call a
 When PR creation returns a subscribable resource hint, subscribe to suggested review/CI events. Report only actionable feedback addressed, build failures fixed, fully green/ready state, or merge.
 
 Return: repo, branch, PR URL/number, checks and results, pre-existing failures, and anything not run with the reason.
-
-When you mention a pull request in a user-facing reply, always include a direct link. Prefer the full PR URL or a Markdown link such as `[#123](https://github.com/owner/repo/pull/123)`. `owner/repo#number` is also fine. Do not leave bare `PR #123` text without a URL or repo.

package/skills/github-code/references/api-surface.md

@@ -80,4 +80,5 @@ jr-rpc config set github.repo owner/repo
 - Pull request reviews and inline review comments use the same repository-scoped `installation-write` credential as other bot-owned PR writes, so they post as Junior even on headless turns. Merge remains denied.
 - If the explicit `git push` fails with 401/403 or another access/permission error, verify the repo context and retry once. If it still fails, load troubleshooting guidance and report the exact command failure.
 - PR comments, labels, and assignees use GitHub's issue endpoints; use the `github-issues` REST guidance for those operations. All allowlisted bot writes share the same repository-scoped `installation-write` credential.
+- To embed a local image in a GitHub issue, pull request, review, or comment, call `publishImage` first. That tool returns a durable public URL. The published image is public to anyone on the internet who has the URL. Embed the URL with normal GitHub Markdown. Do not use private Slack file links or conversation attachment URLs.
 - Return actionable errors for access, permission, not-found, and validation failures.

package/skills/github-issues/SKILL.md

@@ -76,7 +76,7 @@ Follow [references/research-rules.md](references/research-rules.md) for cross-ty
 
 - The runtime adds the verified `Requested by` block. Do not add or rewrite requester attribution in model-authored body text.
 - If the person who originally reported or observed the problem differs from the issue creator, capture that with durable body text such as `Reported by Alice.` or `Raised by Alice during incident triage.`
-- Attach screenshots from the thread as image links when present.
+- Attach screenshots from the thread when present. For GitHub Markdown, first publish each local image with `publishImage` (the image becomes public to anyone with the URL), then embed the returned URL in the issue body or comment. Do not use private Slack file links or conversation attachment URLs.
 - Include code snippets, related issues, and related PRs only when they materially improve the issue.
 
 ### 4. Verify draft