@bretwardjames/ghp-core 0.7.1 → 0.8.0

package/dist/index.cjs

@@ -1908,6 +1908,7 @@ var GitHubAPI = class {
    */
   async getRecentActivity(repo, since, options) {
     if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    const filterUser = options?.user || (options?.mine ? this.username : null);
     const projects = await this.getProjects(repo);
     if (projects.length === 0) return [];
     const allItems = [];
@@ -1921,9 +1922,9 @@ var GitHubAPI = class {
     let recentItems = allItems.filter(
       (item) => item.updatedAt && new Date(item.updatedAt).getTime() >= sinceMs
     );
-    if (options?.mine && this.username) {
+    if (filterUser) {
       recentItems = recentItems.filter(
-        (item) => item.assignees.includes(this.username)
+        (item) => item.assignees.includes(filterUser)
       );
     }
     const seen = /* @__PURE__ */ new Set();
@@ -1968,10 +1969,11 @@ var GitHubAPI = class {
       }
     }
     const activityNumbers = new Set(activities.map((a) => a.issue.number));
-    if (this.username) {
+    const prSearchUser = filterUser || this.username;
+    if (prSearchUser) {
       const reviewActivities = await this.fetchReviewedPRs(
         repo,
-        this.username,
+        prSearchUser,
         sinceDate,
         sinceMs,
         activityNumbers
@@ -1980,11 +1982,9 @@ var GitHubAPI = class {
         activityNumbers.add(a.issue.number);
         activities.push(a);
       }
-    }
-    if (this.username) {
       const authoredActivities = await this.fetchAuthoredPRs(
         repo,
-        this.username,
+        prSearchUser,
         sinceDate,
         sinceMs,
         activityNumbers
@@ -4244,6 +4244,12 @@ function validateUrl(url) {
 
 // src/standup.ts
 function formatStandupText(activities, options) {
+  if (options.timeline) {
+    return formatTimeline(activities, options);
+  }
+  return formatGrouped(activities, options);
+}
+function formatGrouped(activities, options) {
   const { since } = options;
   const lines = [];
   const sinceStr = formatRelativeDate(since);
@@ -4264,6 +4270,35 @@ function formatStandupText(activities, options) {
   }
   return lines.join("\n").trimEnd();
 }
+function formatTimeline(activities, options) {
+  const { since } = options;
+  const lines = [];
+  const allEvents = [];
+  for (const activity of activities) {
+    for (const event of activity.changes) {
+      allEvents.push({ event, issue: activity.issue });
+    }
+  }
+  allEvents.sort(
+    (a, b) => new Date(b.event.timestamp).getTime() - new Date(a.event.timestamp).getTime()
+  );
+  const sinceStr = formatRelativeDate(since);
+  const eventCount = allEvents.length;
+  const issueCount = activities.length;
+  lines.push(`Since ${sinceStr} \u2014 ${eventCount} event${eventCount !== 1 ? "s" : ""} across ${issueCount} issue${issueCount !== 1 ? "s" : ""}`);
+  lines.push("");
+  if (allEvents.length === 0) {
+    lines.push("No activity found in this time window.");
+    return lines.join("\n");
+  }
+  for (const { event, issue } of allEvents) {
+    const time = formatShortTimestamp(event.timestamp);
+    const desc = formatEventDescription(event);
+    const issueRef = `#${issue.number} ${truncate(issue.title, 50)}`;
+    lines.push(`${time}  ${desc}  (${issueRef})`);
+  }
+  return lines.join("\n").trimEnd();
+}
 function parseSince(input) {
   const isoDate = new Date(input);
   if (!isNaN(isoDate.getTime()) && input.includes("-")) {
@@ -4320,6 +4355,41 @@ function formatEventLine(event) {
       return `${arrow} ${event.type} by ${actor} (${timestamp})`;
   }
 }
+function formatEventDescription(event) {
+  const actor = event.actor;
+  switch (event.type) {
+    case "comment":
+      return `Comment by ${actor}${event.details ? ": " + event.details : ""}`;
+    case "labeled":
+      return `Labeled "${event.details}" by ${actor}`;
+    case "unlabeled":
+      return `Unlabeled "${event.details}" by ${actor}`;
+    case "assigned":
+      return `Assigned to ${event.details || actor}`;
+    case "unassigned":
+      return `Unassigned ${event.details || ""} by ${actor}`;
+    case "closed":
+      return `Closed by ${actor}`;
+    case "reopened":
+      return `Reopened by ${actor}`;
+    case "referenced":
+      return `${event.details} linked by ${actor}`;
+    case "review_submitted":
+      return `${event.details} by ${actor}`;
+    case "review_requested":
+      return `Review requested from ${event.details || "team"} by ${actor}`;
+    case "pr_created":
+      return `PR created by ${actor}`;
+    case "pr_merged":
+      return `PR merged by ${actor}`;
+    default:
+      return `${event.type} by ${actor}`;
+  }
+}
+function truncate(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen - 1) + "\u2026";
+}
 function formatRelativeDate(date) {
   const now = /* @__PURE__ */ new Date();
   const diffMs = now.getTime() - date.getTime();

package/dist/index.d.cts

@@ -691,6 +691,7 @@ declare class GitHubAPI {
      */
     getRecentActivity(repo: RepoInfo, since: Date, options?: {
         mine?: boolean;
+        user?: string;
     }): Promise<IssueActivity[]>;
     /**
      * Search for PRs the user reviewed that aren't already in the activity list.
@@ -2283,6 +2284,8 @@ declare function validateUrl(url: string): string;
 interface FormatStandupOptions {
     since: Date;
     colorize?: boolean;
+    /** If true, show a flat chronological timeline instead of grouping by issue */
+    timeline?: boolean;
 }
 /**
  * Format a standup summary as human-readable text.

package/dist/index.d.ts

@@ -691,6 +691,7 @@ declare class GitHubAPI {
      */
     getRecentActivity(repo: RepoInfo, since: Date, options?: {
         mine?: boolean;
+        user?: string;
     }): Promise<IssueActivity[]>;
     /**
      * Search for PRs the user reviewed that aren't already in the activity list.
@@ -2283,6 +2284,8 @@ declare function validateUrl(url: string): string;
 interface FormatStandupOptions {
     since: Date;
     colorize?: boolean;
+    /** If true, show a flat chronological timeline instead of grouping by issue */
+    timeline?: boolean;
 }
 /**
  * Format a standup summary as human-readable text.

package/dist/index.js

@@ -1739,6 +1739,7 @@ var GitHubAPI = class {
    */
   async getRecentActivity(repo, since, options) {
     if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    const filterUser = options?.user || (options?.mine ? this.username : null);
     const projects = await this.getProjects(repo);
     if (projects.length === 0) return [];
     const allItems = [];
@@ -1752,9 +1753,9 @@ var GitHubAPI = class {
     let recentItems = allItems.filter(
       (item) => item.updatedAt && new Date(item.updatedAt).getTime() >= sinceMs
     );
-    if (options?.mine && this.username) {
+    if (filterUser) {
       recentItems = recentItems.filter(
-        (item) => item.assignees.includes(this.username)
+        (item) => item.assignees.includes(filterUser)
       );
     }
     const seen = /* @__PURE__ */ new Set();
@@ -1799,10 +1800,11 @@ var GitHubAPI = class {
       }
     }
     const activityNumbers = new Set(activities.map((a) => a.issue.number));
-    if (this.username) {
+    const prSearchUser = filterUser || this.username;
+    if (prSearchUser) {
       const reviewActivities = await this.fetchReviewedPRs(
         repo,
-        this.username,
+        prSearchUser,
         sinceDate,
         sinceMs,
         activityNumbers
@@ -1811,11 +1813,9 @@ var GitHubAPI = class {
         activityNumbers.add(a.issue.number);
         activities.push(a);
       }
-    }
-    if (this.username) {
       const authoredActivities = await this.fetchAuthoredPRs(
         repo,
-        this.username,
+        prSearchUser,
         sinceDate,
         sinceMs,
         activityNumbers
@@ -4075,6 +4075,12 @@ function validateUrl(url) {
 
 // src/standup.ts
 function formatStandupText(activities, options) {
+  if (options.timeline) {
+    return formatTimeline(activities, options);
+  }
+  return formatGrouped(activities, options);
+}
+function formatGrouped(activities, options) {
   const { since } = options;
   const lines = [];
   const sinceStr = formatRelativeDate(since);
@@ -4095,6 +4101,35 @@ function formatStandupText(activities, options) {
   }
   return lines.join("\n").trimEnd();
 }
+function formatTimeline(activities, options) {
+  const { since } = options;
+  const lines = [];
+  const allEvents = [];
+  for (const activity of activities) {
+    for (const event of activity.changes) {
+      allEvents.push({ event, issue: activity.issue });
+    }
+  }
+  allEvents.sort(
+    (a, b) => new Date(b.event.timestamp).getTime() - new Date(a.event.timestamp).getTime()
+  );
+  const sinceStr = formatRelativeDate(since);
+  const eventCount = allEvents.length;
+  const issueCount = activities.length;
+  lines.push(`Since ${sinceStr} \u2014 ${eventCount} event${eventCount !== 1 ? "s" : ""} across ${issueCount} issue${issueCount !== 1 ? "s" : ""}`);
+  lines.push("");
+  if (allEvents.length === 0) {
+    lines.push("No activity found in this time window.");
+    return lines.join("\n");
+  }
+  for (const { event, issue } of allEvents) {
+    const time = formatShortTimestamp(event.timestamp);
+    const desc = formatEventDescription(event);
+    const issueRef = `#${issue.number} ${truncate(issue.title, 50)}`;
+    lines.push(`${time}  ${desc}  (${issueRef})`);
+  }
+  return lines.join("\n").trimEnd();
+}
 function parseSince(input) {
   const isoDate = new Date(input);
   if (!isNaN(isoDate.getTime()) && input.includes("-")) {
@@ -4151,6 +4186,41 @@ function formatEventLine(event) {
       return `${arrow} ${event.type} by ${actor} (${timestamp})`;
   }
 }
+function formatEventDescription(event) {
+  const actor = event.actor;
+  switch (event.type) {
+    case "comment":
+      return `Comment by ${actor}${event.details ? ": " + event.details : ""}`;
+    case "labeled":
+      return `Labeled "${event.details}" by ${actor}`;
+    case "unlabeled":
+      return `Unlabeled "${event.details}" by ${actor}`;
+    case "assigned":
+      return `Assigned to ${event.details || actor}`;
+    case "unassigned":
+      return `Unassigned ${event.details || ""} by ${actor}`;
+    case "closed":
+      return `Closed by ${actor}`;
+    case "reopened":
+      return `Reopened by ${actor}`;
+    case "referenced":
+      return `${event.details} linked by ${actor}`;
+    case "review_submitted":
+      return `${event.details} by ${actor}`;
+    case "review_requested":
+      return `Review requested from ${event.details || "team"} by ${actor}`;
+    case "pr_created":
+      return `PR created by ${actor}`;
+    case "pr_merged":
+      return `PR merged by ${actor}`;
+    default:
+      return `${event.type} by ${actor}`;
+  }
+}
+function truncate(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen - 1) + "\u2026";
+}
 function formatRelativeDate(date) {
   const now = /* @__PURE__ */ new Date();
   const diffMs = now.getTime() - date.getTime();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bretwardjames/ghp-core",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Shared core library for GitHub Projects tools",
   "main": "dist/index.cjs",
   "module": "dist/index.js",