@bretwardjames/ghp-core 0.6.0 → 0.7.0

package/README.md

@@ -64,6 +64,64 @@ if (result.success) {
 }
 ```
 
+### Error Handling
+
+The `GitError` class provides detailed context for git operation failures:
+
+```typescript
+import { GitError } from '@bretwardjames/ghp-core';
+
+try {
+  await checkoutBranch('nonexistent-branch');
+} catch (error) {
+  if (error instanceof GitError) {
+    console.log(error.command);   // 'git checkout nonexistent-branch'
+    console.log(error.stderr);    // 'error: pathspec ... did not match'
+    console.log(error.exitCode);  // 1
+    console.log(error.cwd);       // '/path/to/repo'
+  }
+}
+```
+
+### Retry Utilities
+
+Handle transient GitHub API failures with exponential backoff:
+
+```typescript
+import { withRetry, isTransientError, DEFAULT_RETRY_CONFIG } from '@bretwardjames/ghp-core';
+
+// Wrap any async function with retry logic
+const result = await withRetry(
+  () => api.getIssue(repo, 123),
+  {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    shouldRetry: isTransientError,  // Retries 429, 5xx, network errors
+  }
+);
+
+// Or use default config
+const result = await withRetry(() => api.getIssue(repo, 123), DEFAULT_RETRY_CONFIG);
+```
+
+### Shell Utilities
+
+Safe shell command construction to prevent injection:
+
+```typescript
+import { shellEscape, validateNumericInput, validateUrl } from '@bretwardjames/ghp-core';
+
+// Escape strings for shell
+const safe = shellEscape("user's input");  // 'user'\''s input'
+
+// Validate numeric input
+const num = validateNumericInput("123", "issue number");  // 123 or throws
+
+// Validate URLs
+validateUrl("https://github.com/...", "issue URL");  // throws if invalid
+```
+
 ### Event Hooks
 
 Register and execute lifecycle event hooks:
@@ -92,6 +150,7 @@ const payload: IssueStartedPayload = {
 // Hooks can execute in a specific directory (e.g., inside a worktree)
 const results = await executeHooksForEvent('issue-started', payload, {
   cwd: '/path/to/worktree',
+  onFailure: 'continue',  // 'fail-fast' (default) or 'continue'
 });
 ```
 

package/dist/index.cjs

@@ -78,6 +78,7 @@ __export(index_exports, {
   findSessionFile: () => findSessionFile,
   formatAction: () => formatAction,
   formatConflict: () => formatConflict,
+  formatStandupText: () => formatStandupText,
   gatherDashboardData: () => gatherDashboardData,
   generateBranchName: () => generateBranchName,
   generateWorktreePath: () => generateWorktreePath,
@@ -135,6 +136,7 @@ __export(index_exports, {
   parseIssueUrl: () => parseIssueUrl,
   parseRateLimitDelay: () => parseRateLimitDelay,
   parseSessionLine: () => parseSessionLine,
+  parseSince: () => parseSince,
   pullLatest: () => pullLatest,
   queries: () => queries_exports,
   registerAgent: () => registerAgent,
@@ -190,6 +192,7 @@ __export(queries_exports, {
   ISSUE_FOR_UPDATE_QUERY: () => ISSUE_FOR_UPDATE_QUERY,
   ISSUE_NODE_ID_QUERY: () => ISSUE_NODE_ID_QUERY,
   ISSUE_RELATIONSHIPS_QUERY: () => ISSUE_RELATIONSHIPS_QUERY,
+  ISSUE_TIMELINE_QUERY: () => ISSUE_TIMELINE_QUERY,
   ISSUE_TYPES_QUERY: () => ISSUE_TYPES_QUERY,
   ISSUE_WITH_PROJECT_ITEMS_QUERY: () => ISSUE_WITH_PROJECT_ITEMS_QUERY,
   LABEL_EXISTS_QUERY: () => LABEL_EXISTS_QUERY,
@@ -280,6 +283,7 @@ var PROJECT_ITEMS_QUERY = `
                                 number
                                 url
                                 state
+                                updatedAt
                                 issueType { name }
                                 assignees(first: 5) { nodes { login } }
                                 labels(first: 10) { nodes { name color } }
@@ -294,6 +298,7 @@ var PROJECT_ITEMS_QUERY = `
                                 number
                                 url
                                 state
+                                updatedAt
                                 merged
                                 assignees(first: 5) { nodes { login } }
                                 labels(first: 10) { nodes { name color } }
@@ -657,6 +662,112 @@ var ISSUE_WITH_PROJECT_ITEMS_QUERY = `
         }
     }
 `;
+var ISSUE_TIMELINE_QUERY = `
+    query($owner: String!, $name: String!, $number: Int!, $since: DateTime!) {
+        repository(owner: $owner, name: $name) {
+            issueOrPullRequest(number: $number) {
+                ... on Issue {
+                    timelineItems(first: 100, since: $since) {
+                        nodes {
+                            __typename
+                            ... on IssueComment {
+                                author { login }
+                                createdAt
+                                body
+                            }
+                            ... on LabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on UnlabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on AssignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on UnassignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on ClosedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on ReopenedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on CrossReferencedEvent {
+                                actor { login }
+                                createdAt
+                                source {
+                                    __typename
+                                    ... on PullRequest { number title url }
+                                    ... on Issue { number title }
+                                }
+                            }
+                        }
+                    }
+                }
+                ... on PullRequest {
+                    timelineItems(first: 100, since: $since) {
+                        nodes {
+                            __typename
+                            ... on IssueComment {
+                                author { login }
+                                createdAt
+                                body
+                            }
+                            ... on LabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on UnlabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on AssignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on UnassignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on ClosedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on ReopenedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on CrossReferencedEvent {
+                                actor { login }
+                                createdAt
+                                source {
+                                    __typename
+                                    ... on PullRequest { number title url }
+                                    ... on Issue { number title }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+`;
 var ISSUE_RELATIONSHIPS_QUERY = `
     query($owner: String!, $name: String!, $number: Int!) {
         repository(owner: $owner, name: $name) {
@@ -1062,7 +1173,8 @@ var GitHubAPI = class {
         parent,
         subIssues,
         blockedBy,
-        blocking
+        blocking,
+        updatedAt: content.updatedAt || null
       };
     });
   }
@@ -1171,7 +1283,8 @@ var GitHubAPI = class {
         parent: issue.parent,
         subIssues: issue.subIssues.nodes,
         blockedBy: issue.blockedBy.nodes,
-        blocking: issue.blocking.nodes
+        blocking: issue.blocking.nodes,
+        updatedAt: null
       };
     } catch (error) {
       return null;
@@ -1733,6 +1846,158 @@ var GitHubAPI = class {
       return null;
     }
   }
+  /**
+   * Get recent activity across all project items since a given time.
+   * Uses a two-pass approach for efficiency:
+   *   Pass 1: Fetch all project items, filter by updatedAt client-side
+   *   Pass 2: Fetch timeline events only for items that changed
+   */
+  async getRecentActivity(repo, since, options) {
+    if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    const projects = await this.getProjects(repo);
+    if (projects.length === 0) return [];
+    const allItems = [];
+    for (const project of projects) {
+      const items = await this.getProjectItems(project.id, project.title);
+      allItems.push(...items);
+    }
+    const sinceMs = since.getTime();
+    const sinceISO = since.toISOString();
+    let recentItems = allItems.filter(
+      (item) => item.updatedAt && new Date(item.updatedAt).getTime() >= sinceMs
+    );
+    if (options?.mine && this.username) {
+      recentItems = recentItems.filter(
+        (item) => item.assignees.includes(this.username)
+      );
+    }
+    const seen = /* @__PURE__ */ new Set();
+    recentItems = recentItems.filter((item) => {
+      const key = `${item.repository || ""}#${item.number}`;
+      if (!item.number || seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    });
+    const activities = [];
+    const BATCH_SIZE = 5;
+    for (let i = 0; i < recentItems.length; i += BATCH_SIZE) {
+      const batch = recentItems.slice(i, i + BATCH_SIZE);
+      const results = await Promise.allSettled(
+        batch.map(async (item) => {
+          if (!item.number || !item.repository) return null;
+          const [owner, name] = item.repository.split("/");
+          if (!owner || !name) return null;
+          const events = await this.fetchTimelineEvents(
+            owner,
+            name,
+            item.number,
+            sinceISO
+          );
+          if (events.length === 0) return null;
+          return {
+            issue: {
+              number: item.number,
+              title: item.title,
+              url: item.url || ""
+            },
+            status: item.status,
+            assignees: item.assignees,
+            changes: events
+          };
+        })
+      );
+      for (const result of results) {
+        if (result.status === "fulfilled" && result.value) {
+          activities.push(result.value);
+        }
+      }
+    }
+    activities.sort((a, b) => {
+      const aLatest = a.changes[a.changes.length - 1]?.timestamp || "";
+      const bLatest = b.changes[b.changes.length - 1]?.timestamp || "";
+      return bLatest.localeCompare(aLatest);
+    });
+    return activities;
+  }
+  /**
+   * Fetch and normalize timeline events for a single issue/PR
+   */
+  async fetchTimelineEvents(owner, name, number, since) {
+    if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    const response = await this.graphqlWithRetry(
+      ISSUE_TIMELINE_QUERY,
+      { owner, name, number, since }
+    );
+    const item = response.repository.issueOrPullRequest;
+    if (!item) return [];
+    const events = [];
+    for (const node of item.timelineItems.nodes) {
+      const actor = node.actor?.login || node.author?.login || "unknown";
+      const timestamp = node.createdAt || "";
+      switch (node.__typename) {
+        case "IssueComment":
+          events.push({
+            type: "comment",
+            actor,
+            timestamp,
+            details: node.body ? node.body.substring(0, 80) + (node.body.length > 80 ? "..." : "") : void 0
+          });
+          break;
+        case "LabeledEvent":
+          events.push({
+            type: "labeled",
+            actor,
+            timestamp,
+            details: node.label?.name
+          });
+          break;
+        case "UnlabeledEvent":
+          events.push({
+            type: "unlabeled",
+            actor,
+            timestamp,
+            details: node.label?.name
+          });
+          break;
+        case "AssignedEvent":
+          events.push({
+            type: "assigned",
+            actor,
+            timestamp,
+            details: node.assignee?.login
+          });
+          break;
+        case "UnassignedEvent":
+          events.push({
+            type: "unassigned",
+            actor,
+            timestamp,
+            details: node.assignee?.login
+          });
+          break;
+        case "ClosedEvent":
+          events.push({ type: "closed", actor, timestamp });
+          break;
+        case "ReopenedEvent":
+          events.push({ type: "reopened", actor, timestamp });
+          break;
+        case "CrossReferencedEvent": {
+          const source = node.source;
+          if (source) {
+            const ref = source.__typename === "PullRequest" ? `PR #${source.number}: ${source.title}` : `#${source.number}: ${source.title}`;
+            events.push({
+              type: "referenced",
+              actor,
+              timestamp,
+              details: ref
+            });
+          }
+          break;
+        }
+      }
+    }
+    return events;
+  }
 };
 
 // src/branch-linker.ts
@@ -3804,6 +4069,106 @@ function validateUrl(url) {
   return url;
 }
 
+// src/standup.ts
+function formatStandupText(activities, options) {
+  const { since } = options;
+  const lines = [];
+  const sinceStr = formatRelativeDate(since);
+  const issueCount = activities.length;
+  lines.push(`Since ${sinceStr} \u2014 ${issueCount} issue${issueCount !== 1 ? "s" : ""} changed`);
+  lines.push("");
+  if (activities.length === 0) {
+    lines.push("No activity found in this time window.");
+    return lines.join("\n");
+  }
+  for (const activity of activities) {
+    const statusTag = activity.status ? ` [${activity.status}]` : "";
+    lines.push(`#${activity.issue.number} ${activity.issue.title}${statusTag}`);
+    for (const event of activity.changes) {
+      lines.push(`  ${formatEventLine(event)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+function parseSince(input) {
+  const isoDate = new Date(input);
+  if (!isNaN(isoDate.getTime()) && input.includes("-")) {
+    return isoDate;
+  }
+  const match = input.match(/^(\d+)\s*(h|d|w)$/i);
+  if (!match) {
+    throw new Error(`Invalid duration format: "${input}". Use formats like "24h", "2d", "1w", or an ISO date.`);
+  }
+  const amount = parseInt(match[1], 10);
+  const unit = match[2].toLowerCase();
+  const now = /* @__PURE__ */ new Date();
+  switch (unit) {
+    case "h":
+      return new Date(now.getTime() - amount * 60 * 60 * 1e3);
+    case "d":
+      return new Date(now.getTime() - amount * 24 * 60 * 60 * 1e3);
+    case "w":
+      return new Date(now.getTime() - amount * 7 * 24 * 60 * 60 * 1e3);
+    default:
+      throw new Error(`Unknown duration unit: "${unit}"`);
+  }
+}
+function formatEventLine(event) {
+  const arrow = "\u2197";
+  const timestamp = formatShortTimestamp(event.timestamp);
+  const actor = event.actor;
+  switch (event.type) {
+    case "comment":
+      return `${arrow} Comment by ${actor} (${timestamp})${event.details ? ": " + event.details : ""}`;
+    case "labeled":
+      return `${arrow} Labeled "${event.details}" by ${actor} (${timestamp})`;
+    case "unlabeled":
+      return `${arrow} Unlabeled "${event.details}" by ${actor} (${timestamp})`;
+    case "assigned":
+      return `${arrow} Assigned to ${event.details || actor} (${timestamp})`;
+    case "unassigned":
+      return `${arrow} Unassigned ${event.details || ""} by ${actor} (${timestamp})`;
+    case "closed":
+      return `${arrow} Closed by ${actor} (${timestamp})`;
+    case "reopened":
+      return `${arrow} Reopened by ${actor} (${timestamp})`;
+    case "referenced":
+      return `${arrow} ${event.details} linked by ${actor} (${timestamp})`;
+    default:
+      return `${arrow} ${event.type} by ${actor} (${timestamp})`;
+  }
+}
+function formatRelativeDate(date) {
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffHours = Math.round(diffMs / (1e3 * 60 * 60));
+  const dateStr = date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+  if (diffHours < 24) {
+    return `${diffHours}h ago (${dateStr})`;
+  } else if (diffHours < 48) {
+    return `yesterday (${dateStr})`;
+  } else {
+    const diffDays = Math.round(diffHours / 24);
+    return `${diffDays} days ago (${dateStr})`;
+  }
+}
+function formatShortTimestamp(isoTimestamp) {
+  if (!isoTimestamp) return "";
+  const date = new Date(isoTimestamp);
+  return date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+
 // src/dashboard/index.ts
 var import_child_process3 = require("child_process");
 var import_util3 = require("util");
@@ -5261,6 +5626,7 @@ EOF
   findSessionFile,
   formatAction,
   formatConflict,
+  formatStandupText,
   gatherDashboardData,
   generateBranchName,
   generateWorktreePath,
@@ -5318,6 +5684,7 @@ EOF
   parseIssueUrl,
   parseRateLimitDelay,
   parseSessionLine,
+  parseSince,
   pullLatest,
   queries,
   registerAgent,

package/dist/index.d.cts

@@ -121,6 +121,7 @@ interface ProjectItem {
     subIssues: RelatedIssue[];
     blockedBy: BlockingIssue[];
     blocking: BlockingIssue[];
+    updatedAt: string | null;
 }
 /**
  * Status field information for a project
@@ -424,6 +425,28 @@ interface BlockingRelationships {
     /** Issues that this issue is blocking (these are blocked by this issue) */
     blocking: BlockingIssue[];
 }
+/**
+ * Activity summary for a single issue/PR
+ */
+interface IssueActivity {
+    issue: {
+        number: number;
+        title: string;
+        url: string;
+    };
+    status: string | null;
+    assignees: string[];
+    changes: ActivityEvent[];
+}
+/**
+ * A single activity event on an issue
+ */
+interface ActivityEvent {
+    type: 'comment' | 'assigned' | 'unassigned' | 'labeled' | 'unlabeled' | 'closed' | 'reopened' | 'referenced';
+    actor: string;
+    timestamp: string;
+    details?: string;
+}
 
 /**
  * GitHub API client for Projects V2.
@@ -658,6 +681,19 @@ declare class GitHubAPI {
      * Get issue relationships (parent, sub-issues, and blocking relationships)
      */
     getIssueRelationships(repo: RepoInfo, issueNumber: number): Promise<IssueRelationships | null>;
+    /**
+     * Get recent activity across all project items since a given time.
+     * Uses a two-pass approach for efficiency:
+     *   Pass 1: Fetch all project items, filter by updatedAt client-side
+     *   Pass 2: Fetch timeline events only for items that changed
+     */
+    getRecentActivity(repo: RepoInfo, since: Date, options?: {
+        mine?: boolean;
+    }): Promise<IssueActivity[]>;
+    /**
+     * Fetch and normalize timeline events for a single issue/PR
+     */
+    private fetchTimelineEvents;
 }
 
 /**
@@ -1110,7 +1146,7 @@ declare const REPOSITORY_ID_QUERY = "\n    query($owner: String!, $name: String!
 /**
  * Query to get project items with all field values (paginated)
  */
-declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!, $cursor: String) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                items(first: 100, after: $cursor) {\n                    pageInfo {\n                        hasNextPage\n                        endCursor\n                    }\n                    nodes {\n                        id\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                        content {\n                            __typename\n                            ... on Issue {\n                                title\n                                number\n                                url\n                                state\n                                issueType { name }\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                                parent { id number title state }\n                                subIssues(first: 50) { nodes { id number title state } }\n                                blockedBy(first: 20) { nodes { id number title state } }\n                                blocking(first: 20) { nodes { id number title state } }\n                            }\n                            ... on PullRequest {\n                                title\n                                number\n                                url\n                                state\n                                merged\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                            }\n                            ... on DraftIssue {\n                                title\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!, $cursor: String) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                items(first: 100, after: $cursor) {\n                    pageInfo {\n                        hasNextPage\n                        endCursor\n                    }\n                    nodes {\n                        id\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                        content {\n                            __typename\n                            ... on Issue {\n                                title\n                                number\n                                url\n                                state\n                                updatedAt\n                                issueType { name }\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                                parent { id number title state }\n                                subIssues(first: 50) { nodes { id number title state } }\n                                blockedBy(first: 20) { nodes { id number title state } }\n                                blocking(first: 20) { nodes { id number title state } }\n                            }\n                            ... on PullRequest {\n                                title\n                                number\n                                url\n                                state\n                                updatedAt\n                                merged\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                            }\n                            ... on DraftIssue {\n                                title\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get project fields (including status options)
  */
@@ -1215,6 +1251,11 @@ declare const REMOVE_BLOCKED_BY_MUTATION = "\n    mutation($issueId: ID!, $block
  * Query to get issue with its project items (direct lookup, no pagination needed)
  */
 declare const ISSUE_WITH_PROJECT_ITEMS_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!) {\n        repository(owner: $owner, name: $name) {\n            issue(number: $number) {\n                id\n                title\n                number\n                url\n                state\n                issueType { name }\n                assignees(first: 5) { nodes { login } }\n                labels(first: 10) { nodes { name color } }\n                parent { id number title state }\n                subIssues(first: 50) { nodes { id number title state } }\n                blockedBy(first: 20) { nodes { id number title state } }\n                blocking(first: 20) { nodes { id number title state } }\n                projectItems(first: 10) {\n                    nodes {\n                        id\n                        project { id title number }\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get timeline events for an issue since a given time.
+ * Used by the standup command to fetch specific activity details.
+ */
+declare const ISSUE_TIMELINE_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!, $since: DateTime!) {\n        repository(owner: $owner, name: $name) {\n            issueOrPullRequest(number: $number) {\n                ... on Issue {\n                    timelineItems(first: 100, since: $since) {\n                        nodes {\n                            __typename\n                            ... on IssueComment {\n                                author { login }\n                                createdAt\n                                body\n                            }\n                            ... on LabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on UnlabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on AssignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on UnassignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on ClosedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on ReopenedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on CrossReferencedEvent {\n                                actor { login }\n                                createdAt\n                                source {\n                                    __typename\n                                    ... on PullRequest { number title url }\n                                    ... on Issue { number title }\n                                }\n                            }\n                        }\n                    }\n                }\n                ... on PullRequest {\n                    timelineItems(first: 100, since: $since) {\n                        nodes {\n                            __typename\n                            ... on IssueComment {\n                                author { login }\n                                createdAt\n                                body\n                            }\n                            ... on LabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on UnlabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on AssignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on UnassignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on ClosedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on ReopenedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on CrossReferencedEvent {\n                                actor { login }\n                                createdAt\n                                source {\n                                    __typename\n                                    ... on PullRequest { number title url }\n                                    ... on Issue { number title }\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get issue relationships (parent and sub-issues)
  */
@@ -1233,6 +1274,7 @@ declare const queries_ISSUE_DETAILS_QUERY: typeof ISSUE_DETAILS_QUERY;
 declare const queries_ISSUE_FOR_UPDATE_QUERY: typeof ISSUE_FOR_UPDATE_QUERY;
 declare const queries_ISSUE_NODE_ID_QUERY: typeof ISSUE_NODE_ID_QUERY;
 declare const queries_ISSUE_RELATIONSHIPS_QUERY: typeof ISSUE_RELATIONSHIPS_QUERY;
+declare const queries_ISSUE_TIMELINE_QUERY: typeof ISSUE_TIMELINE_QUERY;
 declare const queries_ISSUE_TYPES_QUERY: typeof ISSUE_TYPES_QUERY;
 declare const queries_ISSUE_WITH_PROJECT_ITEMS_QUERY: typeof ISSUE_WITH_PROJECT_ITEMS_QUERY;
 declare const queries_LABEL_EXISTS_QUERY: typeof LABEL_EXISTS_QUERY;
@@ -1252,7 +1294,7 @@ declare const queries_UPDATE_ITEM_FIELD_MUTATION: typeof UPDATE_ITEM_FIELD_MUTAT
 declare const queries_UPDATE_ITEM_STATUS_MUTATION: typeof UPDATE_ITEM_STATUS_MUTATION;
 declare const queries_VIEWER_QUERY: typeof VIEWER_QUERY;
 declare namespace queries {
-  export { queries_ADD_BLOCKED_BY_MUTATION as ADD_BLOCKED_BY_MUTATION, queries_ADD_COMMENT_MUTATION as ADD_COMMENT_MUTATION, queries_ADD_LABELS_MUTATION as ADD_LABELS_MUTATION, queries_ADD_SUB_ISSUE_MUTATION as ADD_SUB_ISSUE_MUTATION, queries_ADD_TO_PROJECT_MUTATION as ADD_TO_PROJECT_MUTATION, queries_COLLABORATORS_QUERY as COLLABORATORS_QUERY, queries_CREATE_ISSUE_MUTATION as CREATE_ISSUE_MUTATION, queries_ISSUES_WITH_LABEL_QUERY as ISSUES_WITH_LABEL_QUERY, queries_ISSUE_AND_LABEL_QUERY as ISSUE_AND_LABEL_QUERY, queries_ISSUE_DETAILS_QUERY as ISSUE_DETAILS_QUERY, queries_ISSUE_FOR_UPDATE_QUERY as ISSUE_FOR_UPDATE_QUERY, queries_ISSUE_NODE_ID_QUERY as ISSUE_NODE_ID_QUERY, queries_ISSUE_RELATIONSHIPS_QUERY as ISSUE_RELATIONSHIPS_QUERY, queries_ISSUE_TYPES_QUERY as ISSUE_TYPES_QUERY, queries_ISSUE_WITH_PROJECT_ITEMS_QUERY as ISSUE_WITH_PROJECT_ITEMS_QUERY, queries_LABEL_EXISTS_QUERY as LABEL_EXISTS_QUERY, queries_PROJECT_FIELDS_QUERY as PROJECT_FIELDS_QUERY, queries_PROJECT_ITEMS_QUERY as PROJECT_ITEMS_QUERY, queries_PROJECT_VIEWS_QUERY as PROJECT_VIEWS_QUERY, queries_RECENT_ISSUES_QUERY as RECENT_ISSUES_QUERY, queries_REMOVE_BLOCKED_BY_MUTATION as REMOVE_BLOCKED_BY_MUTATION, queries_REMOVE_LABELS_MUTATION as REMOVE_LABELS_MUTATION, queries_REMOVE_SUB_ISSUE_MUTATION as REMOVE_SUB_ISSUE_MUTATION, queries_REPOSITORY_ID_QUERY as REPOSITORY_ID_QUERY, queries_REPOSITORY_PROJECTS_QUERY as REPOSITORY_PROJECTS_QUERY, queries_UPDATE_ISSUE_BODY_MUTATION as UPDATE_ISSUE_BODY_MUTATION, queries_UPDATE_ISSUE_MUTATION as UPDATE_ISSUE_MUTATION, queries_UPDATE_ISSUE_TYPE_MUTATION as UPDATE_ISSUE_TYPE_MUTATION, queries_UPDATE_ITEM_FIELD_MUTATION as UPDATE_ITEM_FIELD_MUTATION, queries_UPDATE_ITEM_STATUS_MUTATION as UPDATE_ITEM_STATUS_MUTATION, queries_VIEWER_QUERY as VIEWER_QUERY };
+  export { queries_ADD_BLOCKED_BY_MUTATION as ADD_BLOCKED_BY_MUTATION, queries_ADD_COMMENT_MUTATION as ADD_COMMENT_MUTATION, queries_ADD_LABELS_MUTATION as ADD_LABELS_MUTATION, queries_ADD_SUB_ISSUE_MUTATION as ADD_SUB_ISSUE_MUTATION, queries_ADD_TO_PROJECT_MUTATION as ADD_TO_PROJECT_MUTATION, queries_COLLABORATORS_QUERY as COLLABORATORS_QUERY, queries_CREATE_ISSUE_MUTATION as CREATE_ISSUE_MUTATION, queries_ISSUES_WITH_LABEL_QUERY as ISSUES_WITH_LABEL_QUERY, queries_ISSUE_AND_LABEL_QUERY as ISSUE_AND_LABEL_QUERY, queries_ISSUE_DETAILS_QUERY as ISSUE_DETAILS_QUERY, queries_ISSUE_FOR_UPDATE_QUERY as ISSUE_FOR_UPDATE_QUERY, queries_ISSUE_NODE_ID_QUERY as ISSUE_NODE_ID_QUERY, queries_ISSUE_RELATIONSHIPS_QUERY as ISSUE_RELATIONSHIPS_QUERY, queries_ISSUE_TIMELINE_QUERY as ISSUE_TIMELINE_QUERY, queries_ISSUE_TYPES_QUERY as ISSUE_TYPES_QUERY, queries_ISSUE_WITH_PROJECT_ITEMS_QUERY as ISSUE_WITH_PROJECT_ITEMS_QUERY, queries_LABEL_EXISTS_QUERY as LABEL_EXISTS_QUERY, queries_PROJECT_FIELDS_QUERY as PROJECT_FIELDS_QUERY, queries_PROJECT_ITEMS_QUERY as PROJECT_ITEMS_QUERY, queries_PROJECT_VIEWS_QUERY as PROJECT_VIEWS_QUERY, queries_RECENT_ISSUES_QUERY as RECENT_ISSUES_QUERY, queries_REMOVE_BLOCKED_BY_MUTATION as REMOVE_BLOCKED_BY_MUTATION, queries_REMOVE_LABELS_MUTATION as REMOVE_LABELS_MUTATION, queries_REMOVE_SUB_ISSUE_MUTATION as REMOVE_SUB_ISSUE_MUTATION, queries_REPOSITORY_ID_QUERY as REPOSITORY_ID_QUERY, queries_REPOSITORY_PROJECTS_QUERY as REPOSITORY_PROJECTS_QUERY, queries_UPDATE_ISSUE_BODY_MUTATION as UPDATE_ISSUE_BODY_MUTATION, queries_UPDATE_ISSUE_MUTATION as UPDATE_ISSUE_MUTATION, queries_UPDATE_ISSUE_TYPE_MUTATION as UPDATE_ISSUE_TYPE_MUTATION, queries_UPDATE_ITEM_FIELD_MUTATION as UPDATE_ITEM_FIELD_MUTATION, queries_UPDATE_ITEM_STATUS_MUTATION as UPDATE_ITEM_STATUS_MUTATION, queries_VIEWER_QUERY as VIEWER_QUERY };
 }
 
 /**
@@ -2207,6 +2249,33 @@ declare function validateSafeString(value: string, fieldName?: string, pattern?:
  */
 declare function validateUrl(url: string): string;
 
+/**
+ * Standup formatting utilities.
+ *
+ * Provides shared formatting for standup activity summaries,
+ * used by CLI, VS Code extension, and MCP tool.
+ */
+
+/**
+ * Options for formatting standup output
+ */
+interface FormatStandupOptions {
+    since: Date;
+    colorize?: boolean;
+}
+/**
+ * Format a standup summary as human-readable text.
+ *
+ * @param activities - Activity data from GitHubAPI.getRecentActivity()
+ * @param options - Formatting options
+ * @returns Formatted text string
+ */
+declare function formatStandupText(activities: IssueActivity[], options: FormatStandupOptions): string;
+/**
+ * Parse a duration string like "24h", "8h", "2d" or an ISO date into a Date.
+ */
+declare function parseSince(input: string): Date;
+
 /**
  * Dashboard Hooks - Registration and management for external content providers
  *
@@ -3241,4 +3310,4 @@ declare function shouldAbort(results: HookResult[]): boolean;
  */
 declare function hasHooksForEvent(event: EventType): boolean;
 
-export { type AgentInstance, type AgentRegistry, type AgentSessionStatus, type AgentStatus, type AgentSummary, type ApiKeyProvider, type AssigneeInfo, type AuthError, type BaseEventPayload, type BlockingIssue, type BlockingRelationships, type BranchDashboardData, BranchLinker, CLI_TO_VSCODE_MAP, ClaudeClient, type ClaudeClientOptions, type ClaudeResult, type ClaudeTool, type Collaborator, type Commit, type ConflictChoices, type ConflictResolution, type ContentBlock, type CreateIssueOptions, type CreateIssueResult, type CreatePROptions, type CreatePRResult, type CreateWorktreeOptions, type CreateWorktreeResult, DEFAULT_RETRY_CONFIG, DEFAULT_VALUES, type DashboardHook, type DashboardOptions, type DateFieldValue, type DiffStats, type EventHook, type EventHookSettings, type EventHooksConfig, type EventPayload, type EventType, type ExpandIssueOptions, type ExpandedIssue, type FieldInfo, type FieldValue, type FieldValueConnection, type FileChange, GHP_TOOLS, type GeneratePRDescriptionOptions, GitError, GitHubAPI, type GitHubAPIOptions, type GitOptions, type HookExecutionOptions, type HookExecutionResult, type HookExitCodes, type HookItem, type HookMode, type HookOutcome, type HookResponse, type HookResult, type HooksConfig, type IssueCreatedPayload, type IssueDetails, type IssueReference, type IssueRelationships, type IssueStartedPayload, type IterationFieldValue, type LabelInfo, type Message, type NumberFieldValue, type OnFailureBehavior, type PRInfo, type PermissionPrompt, type PlanEpicOptions, type PlanEpicResult, type PrCreatedPayload, type PrCreatingPayload, type PrMergedPayload, type PrePrPayload, type Project, type ProjectConfig, type ProjectConventions, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RegisterAgentOptions, type RelatedIssue, type RemoveWorktreeOptions, type RemoveWorktreeResult, type RepoInfo, type ResolvedClaudeConfig, type ResolvedSettings, type RetryConfig, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SessionEvent, SessionWatcher, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StartIssueOptions, type StartIssueResult, type StatusField, type StreamCallbacks, type StreamErrorEvent, type StreamEvent, type StreamEventBase, type StreamMessageCompleteEvent, type StreamOptions, type StreamTextEvent, type StreamToolInputDeltaEvent, type StreamToolUseCompleteEvent, type StreamToolUseStartEvent, type SyncableSettingKey, type SyncableSettings, TOOL_NAMES, type TextFieldValue, type TokenProvider, type TokenUsage, type ToolContext, type ToolHandler, type ToolHandlers, type UpdateAgentOptions, VSCODE_TO_CLI_MAP, type IssueInfo as WorkflowIssueInfo, type WorkflowResult, type WorktreeInfo as WorkflowWorktreeInfo, type WorktreeCreatedPayload, type WorktreeInfo$1 as WorktreeInfo, type WorktreeRemovedPayload, addEventHook, addHook, branchExists, buildConventionsContext, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, calculateBackoffDelay, checkTmuxForPermission, checkoutBranch, index as claudePrompts, cleanupStaleAgents, computeSettingsDiff, createBranch, createIssueWorkflow, createPRWorkflow, createSessionWatcher, createWorktree, createWorktreeWorkflow, detectRepository, disableEventHook, disableHook, enableEventHook, enableHook, executeAllHooks, executeEventHook, executeHook, executeHooksForEvent, extractIssueNumberFromBranch, fetchOrigin, findSessionFile, formatAction, formatConflict, gatherDashboardData, generateBranchName, generateWorktreePath, getAgent, getAgentByIssue, getAgentSummaries, getAllBranches, getChangedFiles, getCommitHistory, getCommitsAhead, getCommitsBehind, getCurrentBranch$1 as getCurrentBranch, getCurrentBranch as getDashboardCurrentBranch, getDefaultBaseBranch, getDefaultBranch, getDiffStats, getDiffSummary, getEnabledEventHooks, getEnabledHooks, getEventHook, getEventHooks, getEventHooksConfigPath, getEventSettings, getFullDiff, getGitHubRepo, getHook, getHooks, getHooksByCategory, getHooksConfigPath, getHooksForEvent, getIssueReferenceText, getLocalBranches, getRegistryPath, getRemoteBranches, getRepositoryRoot, getTools, getValidEventTypes, getValidModes, getValidOnFailureBehaviors, getWorktreeForBranch, hasDifferences, hasHooksForEvent, hasUncommittedChanges, isGitRepository, isTransientError, listAgents, listWorktrees, loadEventHooksConfig, loadHooksConfig, loadProjectConventions, loadRegistry, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, parseRateLimitDelay, parseSessionLine, pullLatest, queries, registerAgent, removeBranchLinkFromBody, removeEventHook, removeHook, removeWorktree, removeWorktreeWorkflow, resolveConflicts, sanitizeForBranchName, saveEventHooksConfig, saveHooksConfig, saveRegistry, setBranchLinkInBody, shellEscape, shouldAbort, skip, startIssueWorkflow, substituteTemplateVariables, toVSCodeSettings, unregisterAgent, updateAgent, updateEventHook, updateHook, useCli, useCustom, useVSCode, validateNumericInput, validateSafeString, validateUrl, withRetry, worktreeExists, wrapWithRetry };
+export { type ActivityEvent, type AgentInstance, type AgentRegistry, type AgentSessionStatus, type AgentStatus, type AgentSummary, type ApiKeyProvider, type AssigneeInfo, type AuthError, type BaseEventPayload, type BlockingIssue, type BlockingRelationships, type BranchDashboardData, BranchLinker, CLI_TO_VSCODE_MAP, ClaudeClient, type ClaudeClientOptions, type ClaudeResult, type ClaudeTool, type Collaborator, type Commit, type ConflictChoices, type ConflictResolution, type ContentBlock, type CreateIssueOptions, type CreateIssueResult, type CreatePROptions, type CreatePRResult, type CreateWorktreeOptions, type CreateWorktreeResult, DEFAULT_RETRY_CONFIG, DEFAULT_VALUES, type DashboardHook, type DashboardOptions, type DateFieldValue, type DiffStats, type EventHook, type EventHookSettings, type EventHooksConfig, type EventPayload, type EventType, type ExpandIssueOptions, type ExpandedIssue, type FieldInfo, type FieldValue, type FieldValueConnection, type FileChange, type FormatStandupOptions, GHP_TOOLS, type GeneratePRDescriptionOptions, GitError, GitHubAPI, type GitHubAPIOptions, type GitOptions, type HookExecutionOptions, type HookExecutionResult, type HookExitCodes, type HookItem, type HookMode, type HookOutcome, type HookResponse, type HookResult, type HooksConfig, type IssueActivity, type IssueCreatedPayload, type IssueDetails, type IssueReference, type IssueRelationships, type IssueStartedPayload, type IterationFieldValue, type LabelInfo, type Message, type NumberFieldValue, type OnFailureBehavior, type PRInfo, type PermissionPrompt, type PlanEpicOptions, type PlanEpicResult, type PrCreatedPayload, type PrCreatingPayload, type PrMergedPayload, type PrePrPayload, type Project, type ProjectConfig, type ProjectConventions, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RegisterAgentOptions, type RelatedIssue, type RemoveWorktreeOptions, type RemoveWorktreeResult, type RepoInfo, type ResolvedClaudeConfig, type ResolvedSettings, type RetryConfig, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SessionEvent, SessionWatcher, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StartIssueOptions, type StartIssueResult, type StatusField, type StreamCallbacks, type StreamErrorEvent, type StreamEvent, type StreamEventBase, type StreamMessageCompleteEvent, type StreamOptions, type StreamTextEvent, type StreamToolInputDeltaEvent, type StreamToolUseCompleteEvent, type StreamToolUseStartEvent, type SyncableSettingKey, type SyncableSettings, TOOL_NAMES, type TextFieldValue, type TokenProvider, type TokenUsage, type ToolContext, type ToolHandler, type ToolHandlers, type UpdateAgentOptions, VSCODE_TO_CLI_MAP, type IssueInfo as WorkflowIssueInfo, type WorkflowResult, type WorktreeInfo as WorkflowWorktreeInfo, type WorktreeCreatedPayload, type WorktreeInfo$1 as WorktreeInfo, type WorktreeRemovedPayload, addEventHook, addHook, branchExists, buildConventionsContext, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, calculateBackoffDelay, checkTmuxForPermission, checkoutBranch, index as claudePrompts, cleanupStaleAgents, computeSettingsDiff, createBranch, createIssueWorkflow, createPRWorkflow, createSessionWatcher, createWorktree, createWorktreeWorkflow, detectRepository, disableEventHook, disableHook, enableEventHook, enableHook, executeAllHooks, executeEventHook, executeHook, executeHooksForEvent, extractIssueNumberFromBranch, fetchOrigin, findSessionFile, formatAction, formatConflict, formatStandupText, gatherDashboardData, generateBranchName, generateWorktreePath, getAgent, getAgentByIssue, getAgentSummaries, getAllBranches, getChangedFiles, getCommitHistory, getCommitsAhead, getCommitsBehind, getCurrentBranch$1 as getCurrentBranch, getCurrentBranch as getDashboardCurrentBranch, getDefaultBaseBranch, getDefaultBranch, getDiffStats, getDiffSummary, getEnabledEventHooks, getEnabledHooks, getEventHook, getEventHooks, getEventHooksConfigPath, getEventSettings, getFullDiff, getGitHubRepo, getHook, getHooks, getHooksByCategory, getHooksConfigPath, getHooksForEvent, getIssueReferenceText, getLocalBranches, getRegistryPath, getRemoteBranches, getRepositoryRoot, getTools, getValidEventTypes, getValidModes, getValidOnFailureBehaviors, getWorktreeForBranch, hasDifferences, hasHooksForEvent, hasUncommittedChanges, isGitRepository, isTransientError, listAgents, listWorktrees, loadEventHooksConfig, loadHooksConfig, loadProjectConventions, loadRegistry, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, parseRateLimitDelay, parseSessionLine, parseSince, pullLatest, queries, registerAgent, removeBranchLinkFromBody, removeEventHook, removeHook, removeWorktree, removeWorktreeWorkflow, resolveConflicts, sanitizeForBranchName, saveEventHooksConfig, saveHooksConfig, saveRegistry, setBranchLinkInBody, shellEscape, shouldAbort, skip, startIssueWorkflow, substituteTemplateVariables, toVSCodeSettings, unregisterAgent, updateAgent, updateEventHook, updateHook, useCli, useCustom, useVSCode, validateNumericInput, validateSafeString, validateUrl, withRetry, worktreeExists, wrapWithRetry };

package/dist/index.d.ts

@@ -121,6 +121,7 @@ interface ProjectItem {
     subIssues: RelatedIssue[];
     blockedBy: BlockingIssue[];
     blocking: BlockingIssue[];
+    updatedAt: string | null;
 }
 /**
  * Status field information for a project
@@ -424,6 +425,28 @@ interface BlockingRelationships {
     /** Issues that this issue is blocking (these are blocked by this issue) */
     blocking: BlockingIssue[];
 }
+/**
+ * Activity summary for a single issue/PR
+ */
+interface IssueActivity {
+    issue: {
+        number: number;
+        title: string;
+        url: string;
+    };
+    status: string | null;
+    assignees: string[];
+    changes: ActivityEvent[];
+}
+/**
+ * A single activity event on an issue
+ */
+interface ActivityEvent {
+    type: 'comment' | 'assigned' | 'unassigned' | 'labeled' | 'unlabeled' | 'closed' | 'reopened' | 'referenced';
+    actor: string;
+    timestamp: string;
+    details?: string;
+}
 
 /**
  * GitHub API client for Projects V2.
@@ -658,6 +681,19 @@ declare class GitHubAPI {
      * Get issue relationships (parent, sub-issues, and blocking relationships)
      */
     getIssueRelationships(repo: RepoInfo, issueNumber: number): Promise<IssueRelationships | null>;
+    /**
+     * Get recent activity across all project items since a given time.
+     * Uses a two-pass approach for efficiency:
+     *   Pass 1: Fetch all project items, filter by updatedAt client-side
+     *   Pass 2: Fetch timeline events only for items that changed
+     */
+    getRecentActivity(repo: RepoInfo, since: Date, options?: {
+        mine?: boolean;
+    }): Promise<IssueActivity[]>;
+    /**
+     * Fetch and normalize timeline events for a single issue/PR
+     */
+    private fetchTimelineEvents;
 }
 
 /**
@@ -1110,7 +1146,7 @@ declare const REPOSITORY_ID_QUERY = "\n    query($owner: String!, $name: String!
 /**
  * Query to get project items with all field values (paginated)
  */
-declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!, $cursor: String) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                items(first: 100, after: $cursor) {\n                    pageInfo {\n                        hasNextPage\n                        endCursor\n                    }\n                    nodes {\n                        id\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                        content {\n                            __typename\n                            ... on Issue {\n                                title\n                                number\n                                url\n                                state\n                                issueType { name }\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                                parent { id number title state }\n                                subIssues(first: 50) { nodes { id number title state } }\n                                blockedBy(first: 20) { nodes { id number title state } }\n                                blocking(first: 20) { nodes { id number title state } }\n                            }\n                            ... on PullRequest {\n                                title\n                                number\n                                url\n                                state\n                                merged\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                            }\n                            ... on DraftIssue {\n                                title\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!, $cursor: String) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                items(first: 100, after: $cursor) {\n                    pageInfo {\n                        hasNextPage\n                        endCursor\n                    }\n                    nodes {\n                        id\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                        content {\n                            __typename\n                            ... on Issue {\n                                title\n                                number\n                                url\n                                state\n                                updatedAt\n                                issueType { name }\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                                parent { id number title state }\n                                subIssues(first: 50) { nodes { id number title state } }\n                                blockedBy(first: 20) { nodes { id number title state } }\n                                blocking(first: 20) { nodes { id number title state } }\n                            }\n                            ... on PullRequest {\n                                title\n                                number\n                                url\n                                state\n                                updatedAt\n                                merged\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name owner { login } }\n                            }\n                            ... on DraftIssue {\n                                title\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get project fields (including status options)
  */
@@ -1215,6 +1251,11 @@ declare const REMOVE_BLOCKED_BY_MUTATION = "\n    mutation($issueId: ID!, $block
  * Query to get issue with its project items (direct lookup, no pagination needed)
  */
 declare const ISSUE_WITH_PROJECT_ITEMS_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!) {\n        repository(owner: $owner, name: $name) {\n            issue(number: $number) {\n                id\n                title\n                number\n                url\n                state\n                issueType { name }\n                assignees(first: 5) { nodes { login } }\n                labels(first: 10) { nodes { name color } }\n                parent { id number title state }\n                subIssues(first: 50) { nodes { id number title state } }\n                blockedBy(first: 20) { nodes { id number title state } }\n                blocking(first: 20) { nodes { id number title state } }\n                projectItems(first: 10) {\n                    nodes {\n                        id\n                        project { id title number }\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get timeline events for an issue since a given time.
+ * Used by the standup command to fetch specific activity details.
+ */
+declare const ISSUE_TIMELINE_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!, $since: DateTime!) {\n        repository(owner: $owner, name: $name) {\n            issueOrPullRequest(number: $number) {\n                ... on Issue {\n                    timelineItems(first: 100, since: $since) {\n                        nodes {\n                            __typename\n                            ... on IssueComment {\n                                author { login }\n                                createdAt\n                                body\n                            }\n                            ... on LabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on UnlabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on AssignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on UnassignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on ClosedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on ReopenedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on CrossReferencedEvent {\n                                actor { login }\n                                createdAt\n                                source {\n                                    __typename\n                                    ... on PullRequest { number title url }\n                                    ... on Issue { number title }\n                                }\n                            }\n                        }\n                    }\n                }\n                ... on PullRequest {\n                    timelineItems(first: 100, since: $since) {\n                        nodes {\n                            __typename\n                            ... on IssueComment {\n                                author { login }\n                                createdAt\n                                body\n                            }\n                            ... on LabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on UnlabeledEvent {\n                                actor { login }\n                                createdAt\n                                label { name }\n                            }\n                            ... on AssignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on UnassignedEvent {\n                                actor { login }\n                                createdAt\n                                assignee { ... on User { login } }\n                            }\n                            ... on ClosedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on ReopenedEvent {\n                                actor { login }\n                                createdAt\n                            }\n                            ... on CrossReferencedEvent {\n                                actor { login }\n                                createdAt\n                                source {\n                                    __typename\n                                    ... on PullRequest { number title url }\n                                    ... on Issue { number title }\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get issue relationships (parent and sub-issues)
  */
@@ -1233,6 +1274,7 @@ declare const queries_ISSUE_DETAILS_QUERY: typeof ISSUE_DETAILS_QUERY;
 declare const queries_ISSUE_FOR_UPDATE_QUERY: typeof ISSUE_FOR_UPDATE_QUERY;
 declare const queries_ISSUE_NODE_ID_QUERY: typeof ISSUE_NODE_ID_QUERY;
 declare const queries_ISSUE_RELATIONSHIPS_QUERY: typeof ISSUE_RELATIONSHIPS_QUERY;
+declare const queries_ISSUE_TIMELINE_QUERY: typeof ISSUE_TIMELINE_QUERY;
 declare const queries_ISSUE_TYPES_QUERY: typeof ISSUE_TYPES_QUERY;
 declare const queries_ISSUE_WITH_PROJECT_ITEMS_QUERY: typeof ISSUE_WITH_PROJECT_ITEMS_QUERY;
 declare const queries_LABEL_EXISTS_QUERY: typeof LABEL_EXISTS_QUERY;
@@ -1252,7 +1294,7 @@ declare const queries_UPDATE_ITEM_FIELD_MUTATION: typeof UPDATE_ITEM_FIELD_MUTAT
 declare const queries_UPDATE_ITEM_STATUS_MUTATION: typeof UPDATE_ITEM_STATUS_MUTATION;
 declare const queries_VIEWER_QUERY: typeof VIEWER_QUERY;
 declare namespace queries {
-  export { queries_ADD_BLOCKED_BY_MUTATION as ADD_BLOCKED_BY_MUTATION, queries_ADD_COMMENT_MUTATION as ADD_COMMENT_MUTATION, queries_ADD_LABELS_MUTATION as ADD_LABELS_MUTATION, queries_ADD_SUB_ISSUE_MUTATION as ADD_SUB_ISSUE_MUTATION, queries_ADD_TO_PROJECT_MUTATION as ADD_TO_PROJECT_MUTATION, queries_COLLABORATORS_QUERY as COLLABORATORS_QUERY, queries_CREATE_ISSUE_MUTATION as CREATE_ISSUE_MUTATION, queries_ISSUES_WITH_LABEL_QUERY as ISSUES_WITH_LABEL_QUERY, queries_ISSUE_AND_LABEL_QUERY as ISSUE_AND_LABEL_QUERY, queries_ISSUE_DETAILS_QUERY as ISSUE_DETAILS_QUERY, queries_ISSUE_FOR_UPDATE_QUERY as ISSUE_FOR_UPDATE_QUERY, queries_ISSUE_NODE_ID_QUERY as ISSUE_NODE_ID_QUERY, queries_ISSUE_RELATIONSHIPS_QUERY as ISSUE_RELATIONSHIPS_QUERY, queries_ISSUE_TYPES_QUERY as ISSUE_TYPES_QUERY, queries_ISSUE_WITH_PROJECT_ITEMS_QUERY as ISSUE_WITH_PROJECT_ITEMS_QUERY, queries_LABEL_EXISTS_QUERY as LABEL_EXISTS_QUERY, queries_PROJECT_FIELDS_QUERY as PROJECT_FIELDS_QUERY, queries_PROJECT_ITEMS_QUERY as PROJECT_ITEMS_QUERY, queries_PROJECT_VIEWS_QUERY as PROJECT_VIEWS_QUERY, queries_RECENT_ISSUES_QUERY as RECENT_ISSUES_QUERY, queries_REMOVE_BLOCKED_BY_MUTATION as REMOVE_BLOCKED_BY_MUTATION, queries_REMOVE_LABELS_MUTATION as REMOVE_LABELS_MUTATION, queries_REMOVE_SUB_ISSUE_MUTATION as REMOVE_SUB_ISSUE_MUTATION, queries_REPOSITORY_ID_QUERY as REPOSITORY_ID_QUERY, queries_REPOSITORY_PROJECTS_QUERY as REPOSITORY_PROJECTS_QUERY, queries_UPDATE_ISSUE_BODY_MUTATION as UPDATE_ISSUE_BODY_MUTATION, queries_UPDATE_ISSUE_MUTATION as UPDATE_ISSUE_MUTATION, queries_UPDATE_ISSUE_TYPE_MUTATION as UPDATE_ISSUE_TYPE_MUTATION, queries_UPDATE_ITEM_FIELD_MUTATION as UPDATE_ITEM_FIELD_MUTATION, queries_UPDATE_ITEM_STATUS_MUTATION as UPDATE_ITEM_STATUS_MUTATION, queries_VIEWER_QUERY as VIEWER_QUERY };
+  export { queries_ADD_BLOCKED_BY_MUTATION as ADD_BLOCKED_BY_MUTATION, queries_ADD_COMMENT_MUTATION as ADD_COMMENT_MUTATION, queries_ADD_LABELS_MUTATION as ADD_LABELS_MUTATION, queries_ADD_SUB_ISSUE_MUTATION as ADD_SUB_ISSUE_MUTATION, queries_ADD_TO_PROJECT_MUTATION as ADD_TO_PROJECT_MUTATION, queries_COLLABORATORS_QUERY as COLLABORATORS_QUERY, queries_CREATE_ISSUE_MUTATION as CREATE_ISSUE_MUTATION, queries_ISSUES_WITH_LABEL_QUERY as ISSUES_WITH_LABEL_QUERY, queries_ISSUE_AND_LABEL_QUERY as ISSUE_AND_LABEL_QUERY, queries_ISSUE_DETAILS_QUERY as ISSUE_DETAILS_QUERY, queries_ISSUE_FOR_UPDATE_QUERY as ISSUE_FOR_UPDATE_QUERY, queries_ISSUE_NODE_ID_QUERY as ISSUE_NODE_ID_QUERY, queries_ISSUE_RELATIONSHIPS_QUERY as ISSUE_RELATIONSHIPS_QUERY, queries_ISSUE_TIMELINE_QUERY as ISSUE_TIMELINE_QUERY, queries_ISSUE_TYPES_QUERY as ISSUE_TYPES_QUERY, queries_ISSUE_WITH_PROJECT_ITEMS_QUERY as ISSUE_WITH_PROJECT_ITEMS_QUERY, queries_LABEL_EXISTS_QUERY as LABEL_EXISTS_QUERY, queries_PROJECT_FIELDS_QUERY as PROJECT_FIELDS_QUERY, queries_PROJECT_ITEMS_QUERY as PROJECT_ITEMS_QUERY, queries_PROJECT_VIEWS_QUERY as PROJECT_VIEWS_QUERY, queries_RECENT_ISSUES_QUERY as RECENT_ISSUES_QUERY, queries_REMOVE_BLOCKED_BY_MUTATION as REMOVE_BLOCKED_BY_MUTATION, queries_REMOVE_LABELS_MUTATION as REMOVE_LABELS_MUTATION, queries_REMOVE_SUB_ISSUE_MUTATION as REMOVE_SUB_ISSUE_MUTATION, queries_REPOSITORY_ID_QUERY as REPOSITORY_ID_QUERY, queries_REPOSITORY_PROJECTS_QUERY as REPOSITORY_PROJECTS_QUERY, queries_UPDATE_ISSUE_BODY_MUTATION as UPDATE_ISSUE_BODY_MUTATION, queries_UPDATE_ISSUE_MUTATION as UPDATE_ISSUE_MUTATION, queries_UPDATE_ISSUE_TYPE_MUTATION as UPDATE_ISSUE_TYPE_MUTATION, queries_UPDATE_ITEM_FIELD_MUTATION as UPDATE_ITEM_FIELD_MUTATION, queries_UPDATE_ITEM_STATUS_MUTATION as UPDATE_ITEM_STATUS_MUTATION, queries_VIEWER_QUERY as VIEWER_QUERY };
 }
 
 /**
@@ -2207,6 +2249,33 @@ declare function validateSafeString(value: string, fieldName?: string, pattern?:
  */
 declare function validateUrl(url: string): string;
 
+/**
+ * Standup formatting utilities.
+ *
+ * Provides shared formatting for standup activity summaries,
+ * used by CLI, VS Code extension, and MCP tool.
+ */
+
+/**
+ * Options for formatting standup output
+ */
+interface FormatStandupOptions {
+    since: Date;
+    colorize?: boolean;
+}
+/**
+ * Format a standup summary as human-readable text.
+ *
+ * @param activities - Activity data from GitHubAPI.getRecentActivity()
+ * @param options - Formatting options
+ * @returns Formatted text string
+ */
+declare function formatStandupText(activities: IssueActivity[], options: FormatStandupOptions): string;
+/**
+ * Parse a duration string like "24h", "8h", "2d" or an ISO date into a Date.
+ */
+declare function parseSince(input: string): Date;
+
 /**
  * Dashboard Hooks - Registration and management for external content providers
  *
@@ -3241,4 +3310,4 @@ declare function shouldAbort(results: HookResult[]): boolean;
  */
 declare function hasHooksForEvent(event: EventType): boolean;
 
-export { type AgentInstance, type AgentRegistry, type AgentSessionStatus, type AgentStatus, type AgentSummary, type ApiKeyProvider, type AssigneeInfo, type AuthError, type BaseEventPayload, type BlockingIssue, type BlockingRelationships, type BranchDashboardData, BranchLinker, CLI_TO_VSCODE_MAP, ClaudeClient, type ClaudeClientOptions, type ClaudeResult, type ClaudeTool, type Collaborator, type Commit, type ConflictChoices, type ConflictResolution, type ContentBlock, type CreateIssueOptions, type CreateIssueResult, type CreatePROptions, type CreatePRResult, type CreateWorktreeOptions, type CreateWorktreeResult, DEFAULT_RETRY_CONFIG, DEFAULT_VALUES, type DashboardHook, type DashboardOptions, type DateFieldValue, type DiffStats, type EventHook, type EventHookSettings, type EventHooksConfig, type EventPayload, type EventType, type ExpandIssueOptions, type ExpandedIssue, type FieldInfo, type FieldValue, type FieldValueConnection, type FileChange, GHP_TOOLS, type GeneratePRDescriptionOptions, GitError, GitHubAPI, type GitHubAPIOptions, type GitOptions, type HookExecutionOptions, type HookExecutionResult, type HookExitCodes, type HookItem, type HookMode, type HookOutcome, type HookResponse, type HookResult, type HooksConfig, type IssueCreatedPayload, type IssueDetails, type IssueReference, type IssueRelationships, type IssueStartedPayload, type IterationFieldValue, type LabelInfo, type Message, type NumberFieldValue, type OnFailureBehavior, type PRInfo, type PermissionPrompt, type PlanEpicOptions, type PlanEpicResult, type PrCreatedPayload, type PrCreatingPayload, type PrMergedPayload, type PrePrPayload, type Project, type ProjectConfig, type ProjectConventions, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RegisterAgentOptions, type RelatedIssue, type RemoveWorktreeOptions, type RemoveWorktreeResult, type RepoInfo, type ResolvedClaudeConfig, type ResolvedSettings, type RetryConfig, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SessionEvent, SessionWatcher, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StartIssueOptions, type StartIssueResult, type StatusField, type StreamCallbacks, type StreamErrorEvent, type StreamEvent, type StreamEventBase, type StreamMessageCompleteEvent, type StreamOptions, type StreamTextEvent, type StreamToolInputDeltaEvent, type StreamToolUseCompleteEvent, type StreamToolUseStartEvent, type SyncableSettingKey, type SyncableSettings, TOOL_NAMES, type TextFieldValue, type TokenProvider, type TokenUsage, type ToolContext, type ToolHandler, type ToolHandlers, type UpdateAgentOptions, VSCODE_TO_CLI_MAP, type IssueInfo as WorkflowIssueInfo, type WorkflowResult, type WorktreeInfo as WorkflowWorktreeInfo, type WorktreeCreatedPayload, type WorktreeInfo$1 as WorktreeInfo, type WorktreeRemovedPayload, addEventHook, addHook, branchExists, buildConventionsContext, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, calculateBackoffDelay, checkTmuxForPermission, checkoutBranch, index as claudePrompts, cleanupStaleAgents, computeSettingsDiff, createBranch, createIssueWorkflow, createPRWorkflow, createSessionWatcher, createWorktree, createWorktreeWorkflow, detectRepository, disableEventHook, disableHook, enableEventHook, enableHook, executeAllHooks, executeEventHook, executeHook, executeHooksForEvent, extractIssueNumberFromBranch, fetchOrigin, findSessionFile, formatAction, formatConflict, gatherDashboardData, generateBranchName, generateWorktreePath, getAgent, getAgentByIssue, getAgentSummaries, getAllBranches, getChangedFiles, getCommitHistory, getCommitsAhead, getCommitsBehind, getCurrentBranch$1 as getCurrentBranch, getCurrentBranch as getDashboardCurrentBranch, getDefaultBaseBranch, getDefaultBranch, getDiffStats, getDiffSummary, getEnabledEventHooks, getEnabledHooks, getEventHook, getEventHooks, getEventHooksConfigPath, getEventSettings, getFullDiff, getGitHubRepo, getHook, getHooks, getHooksByCategory, getHooksConfigPath, getHooksForEvent, getIssueReferenceText, getLocalBranches, getRegistryPath, getRemoteBranches, getRepositoryRoot, getTools, getValidEventTypes, getValidModes, getValidOnFailureBehaviors, getWorktreeForBranch, hasDifferences, hasHooksForEvent, hasUncommittedChanges, isGitRepository, isTransientError, listAgents, listWorktrees, loadEventHooksConfig, loadHooksConfig, loadProjectConventions, loadRegistry, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, parseRateLimitDelay, parseSessionLine, pullLatest, queries, registerAgent, removeBranchLinkFromBody, removeEventHook, removeHook, removeWorktree, removeWorktreeWorkflow, resolveConflicts, sanitizeForBranchName, saveEventHooksConfig, saveHooksConfig, saveRegistry, setBranchLinkInBody, shellEscape, shouldAbort, skip, startIssueWorkflow, substituteTemplateVariables, toVSCodeSettings, unregisterAgent, updateAgent, updateEventHook, updateHook, useCli, useCustom, useVSCode, validateNumericInput, validateSafeString, validateUrl, withRetry, worktreeExists, wrapWithRetry };
+export { type ActivityEvent, type AgentInstance, type AgentRegistry, type AgentSessionStatus, type AgentStatus, type AgentSummary, type ApiKeyProvider, type AssigneeInfo, type AuthError, type BaseEventPayload, type BlockingIssue, type BlockingRelationships, type BranchDashboardData, BranchLinker, CLI_TO_VSCODE_MAP, ClaudeClient, type ClaudeClientOptions, type ClaudeResult, type ClaudeTool, type Collaborator, type Commit, type ConflictChoices, type ConflictResolution, type ContentBlock, type CreateIssueOptions, type CreateIssueResult, type CreatePROptions, type CreatePRResult, type CreateWorktreeOptions, type CreateWorktreeResult, DEFAULT_RETRY_CONFIG, DEFAULT_VALUES, type DashboardHook, type DashboardOptions, type DateFieldValue, type DiffStats, type EventHook, type EventHookSettings, type EventHooksConfig, type EventPayload, type EventType, type ExpandIssueOptions, type ExpandedIssue, type FieldInfo, type FieldValue, type FieldValueConnection, type FileChange, type FormatStandupOptions, GHP_TOOLS, type GeneratePRDescriptionOptions, GitError, GitHubAPI, type GitHubAPIOptions, type GitOptions, type HookExecutionOptions, type HookExecutionResult, type HookExitCodes, type HookItem, type HookMode, type HookOutcome, type HookResponse, type HookResult, type HooksConfig, type IssueActivity, type IssueCreatedPayload, type IssueDetails, type IssueReference, type IssueRelationships, type IssueStartedPayload, type IterationFieldValue, type LabelInfo, type Message, type NumberFieldValue, type OnFailureBehavior, type PRInfo, type PermissionPrompt, type PlanEpicOptions, type PlanEpicResult, type PrCreatedPayload, type PrCreatingPayload, type PrMergedPayload, type PrePrPayload, type Project, type ProjectConfig, type ProjectConventions, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RegisterAgentOptions, type RelatedIssue, type RemoveWorktreeOptions, type RemoveWorktreeResult, type RepoInfo, type ResolvedClaudeConfig, type ResolvedSettings, type RetryConfig, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SessionEvent, SessionWatcher, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StartIssueOptions, type StartIssueResult, type StatusField, type StreamCallbacks, type StreamErrorEvent, type StreamEvent, type StreamEventBase, type StreamMessageCompleteEvent, type StreamOptions, type StreamTextEvent, type StreamToolInputDeltaEvent, type StreamToolUseCompleteEvent, type StreamToolUseStartEvent, type SyncableSettingKey, type SyncableSettings, TOOL_NAMES, type TextFieldValue, type TokenProvider, type TokenUsage, type ToolContext, type ToolHandler, type ToolHandlers, type UpdateAgentOptions, VSCODE_TO_CLI_MAP, type IssueInfo as WorkflowIssueInfo, type WorkflowResult, type WorktreeInfo as WorkflowWorktreeInfo, type WorktreeCreatedPayload, type WorktreeInfo$1 as WorktreeInfo, type WorktreeRemovedPayload, addEventHook, addHook, branchExists, buildConventionsContext, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, calculateBackoffDelay, checkTmuxForPermission, checkoutBranch, index as claudePrompts, cleanupStaleAgents, computeSettingsDiff, createBranch, createIssueWorkflow, createPRWorkflow, createSessionWatcher, createWorktree, createWorktreeWorkflow, detectRepository, disableEventHook, disableHook, enableEventHook, enableHook, executeAllHooks, executeEventHook, executeHook, executeHooksForEvent, extractIssueNumberFromBranch, fetchOrigin, findSessionFile, formatAction, formatConflict, formatStandupText, gatherDashboardData, generateBranchName, generateWorktreePath, getAgent, getAgentByIssue, getAgentSummaries, getAllBranches, getChangedFiles, getCommitHistory, getCommitsAhead, getCommitsBehind, getCurrentBranch$1 as getCurrentBranch, getCurrentBranch as getDashboardCurrentBranch, getDefaultBaseBranch, getDefaultBranch, getDiffStats, getDiffSummary, getEnabledEventHooks, getEnabledHooks, getEventHook, getEventHooks, getEventHooksConfigPath, getEventSettings, getFullDiff, getGitHubRepo, getHook, getHooks, getHooksByCategory, getHooksConfigPath, getHooksForEvent, getIssueReferenceText, getLocalBranches, getRegistryPath, getRemoteBranches, getRepositoryRoot, getTools, getValidEventTypes, getValidModes, getValidOnFailureBehaviors, getWorktreeForBranch, hasDifferences, hasHooksForEvent, hasUncommittedChanges, isGitRepository, isTransientError, listAgents, listWorktrees, loadEventHooksConfig, loadHooksConfig, loadProjectConventions, loadRegistry, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, parseRateLimitDelay, parseSessionLine, parseSince, pullLatest, queries, registerAgent, removeBranchLinkFromBody, removeEventHook, removeHook, removeWorktree, removeWorktreeWorkflow, resolveConflicts, sanitizeForBranchName, saveEventHooksConfig, saveHooksConfig, saveRegistry, setBranchLinkInBody, shellEscape, shouldAbort, skip, startIssueWorkflow, substituteTemplateVariables, toVSCodeSettings, unregisterAgent, updateAgent, updateEventHook, updateHook, useCli, useCustom, useVSCode, validateNumericInput, validateSafeString, validateUrl, withRetry, worktreeExists, wrapWithRetry };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(queries_exports, {
   ISSUE_FOR_UPDATE_QUERY: () => ISSUE_FOR_UPDATE_QUERY,
   ISSUE_NODE_ID_QUERY: () => ISSUE_NODE_ID_QUERY,
   ISSUE_RELATIONSHIPS_QUERY: () => ISSUE_RELATIONSHIPS_QUERY,
+  ISSUE_TIMELINE_QUERY: () => ISSUE_TIMELINE_QUERY,
   ISSUE_TYPES_QUERY: () => ISSUE_TYPES_QUERY,
   ISSUE_WITH_PROJECT_ITEMS_QUERY: () => ISSUE_WITH_PROJECT_ITEMS_QUERY,
   LABEL_EXISTS_QUERY: () => LABEL_EXISTS_QUERY,
@@ -113,6 +114,7 @@ var PROJECT_ITEMS_QUERY = `
                                 number
                                 url
                                 state
+                                updatedAt
                                 issueType { name }
                                 assignees(first: 5) { nodes { login } }
                                 labels(first: 10) { nodes { name color } }
@@ -127,6 +129,7 @@ var PROJECT_ITEMS_QUERY = `
                                 number
                                 url
                                 state
+                                updatedAt
                                 merged
                                 assignees(first: 5) { nodes { login } }
                                 labels(first: 10) { nodes { name color } }
@@ -490,6 +493,112 @@ var ISSUE_WITH_PROJECT_ITEMS_QUERY = `
         }
     }
 `;
+var ISSUE_TIMELINE_QUERY = `
+    query($owner: String!, $name: String!, $number: Int!, $since: DateTime!) {
+        repository(owner: $owner, name: $name) {
+            issueOrPullRequest(number: $number) {
+                ... on Issue {
+                    timelineItems(first: 100, since: $since) {
+                        nodes {
+                            __typename
+                            ... on IssueComment {
+                                author { login }
+                                createdAt
+                                body
+                            }
+                            ... on LabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on UnlabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on AssignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on UnassignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on ClosedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on ReopenedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on CrossReferencedEvent {
+                                actor { login }
+                                createdAt
+                                source {
+                                    __typename
+                                    ... on PullRequest { number title url }
+                                    ... on Issue { number title }
+                                }
+                            }
+                        }
+                    }
+                }
+                ... on PullRequest {
+                    timelineItems(first: 100, since: $since) {
+                        nodes {
+                            __typename
+                            ... on IssueComment {
+                                author { login }
+                                createdAt
+                                body
+                            }
+                            ... on LabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on UnlabeledEvent {
+                                actor { login }
+                                createdAt
+                                label { name }
+                            }
+                            ... on AssignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on UnassignedEvent {
+                                actor { login }
+                                createdAt
+                                assignee { ... on User { login } }
+                            }
+                            ... on ClosedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on ReopenedEvent {
+                                actor { login }
+                                createdAt
+                            }
+                            ... on CrossReferencedEvent {
+                                actor { login }
+                                createdAt
+                                source {
+                                    __typename
+                                    ... on PullRequest { number title url }
+                                    ... on Issue { number title }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+`;
 var ISSUE_RELATIONSHIPS_QUERY = `
     query($owner: String!, $name: String!, $number: Int!) {
         repository(owner: $owner, name: $name) {
@@ -895,7 +1004,8 @@ var GitHubAPI = class {
         parent,
         subIssues,
         blockedBy,
-        blocking
+        blocking,
+        updatedAt: content.updatedAt || null
       };
     });
   }
@@ -1004,7 +1114,8 @@ var GitHubAPI = class {
         parent: issue.parent,
         subIssues: issue.subIssues.nodes,
         blockedBy: issue.blockedBy.nodes,
-        blocking: issue.blocking.nodes
+        blocking: issue.blocking.nodes,
+        updatedAt: null
       };
     } catch (error) {
       return null;
@@ -1566,6 +1677,158 @@ var GitHubAPI = class {
       return null;
     }
   }
+  /**
+   * Get recent activity across all project items since a given time.
+   * Uses a two-pass approach for efficiency:
+   *   Pass 1: Fetch all project items, filter by updatedAt client-side
+   *   Pass 2: Fetch timeline events only for items that changed
+   */
+  async getRecentActivity(repo, since, options) {
+    if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    const projects = await this.getProjects(repo);
+    if (projects.length === 0) return [];
+    const allItems = [];
+    for (const project of projects) {
+      const items = await this.getProjectItems(project.id, project.title);
+      allItems.push(...items);
+    }
+    const sinceMs = since.getTime();
+    const sinceISO = since.toISOString();
+    let recentItems = allItems.filter(
+      (item) => item.updatedAt && new Date(item.updatedAt).getTime() >= sinceMs
+    );
+    if (options?.mine && this.username) {
+      recentItems = recentItems.filter(
+        (item) => item.assignees.includes(this.username)
+      );
+    }
+    const seen = /* @__PURE__ */ new Set();
+    recentItems = recentItems.filter((item) => {
+      const key = `${item.repository || ""}#${item.number}`;
+      if (!item.number || seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    });
+    const activities = [];
+    const BATCH_SIZE = 5;
+    for (let i = 0; i < recentItems.length; i += BATCH_SIZE) {
+      const batch = recentItems.slice(i, i + BATCH_SIZE);
+      const results = await Promise.allSettled(
+        batch.map(async (item) => {
+          if (!item.number || !item.repository) return null;
+          const [owner, name] = item.repository.split("/");
+          if (!owner || !name) return null;
+          const events = await this.fetchTimelineEvents(
+            owner,
+            name,
+            item.number,
+            sinceISO
+          );
+          if (events.length === 0) return null;
+          return {
+            issue: {
+              number: item.number,
+              title: item.title,
+              url: item.url || ""
+            },
+            status: item.status,
+            assignees: item.assignees,
+            changes: events
+          };
+        })
+      );
+      for (const result of results) {
+        if (result.status === "fulfilled" && result.value) {
+          activities.push(result.value);
+        }
+      }
+    }
+    activities.sort((a, b) => {
+      const aLatest = a.changes[a.changes.length - 1]?.timestamp || "";
+      const bLatest = b.changes[b.changes.length - 1]?.timestamp || "";
+      return bLatest.localeCompare(aLatest);
+    });
+    return activities;
+  }
+  /**
+   * Fetch and normalize timeline events for a single issue/PR
+   */
+  async fetchTimelineEvents(owner, name, number, since) {
+    if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    const response = await this.graphqlWithRetry(
+      ISSUE_TIMELINE_QUERY,
+      { owner, name, number, since }
+    );
+    const item = response.repository.issueOrPullRequest;
+    if (!item) return [];
+    const events = [];
+    for (const node of item.timelineItems.nodes) {
+      const actor = node.actor?.login || node.author?.login || "unknown";
+      const timestamp = node.createdAt || "";
+      switch (node.__typename) {
+        case "IssueComment":
+          events.push({
+            type: "comment",
+            actor,
+            timestamp,
+            details: node.body ? node.body.substring(0, 80) + (node.body.length > 80 ? "..." : "") : void 0
+          });
+          break;
+        case "LabeledEvent":
+          events.push({
+            type: "labeled",
+            actor,
+            timestamp,
+            details: node.label?.name
+          });
+          break;
+        case "UnlabeledEvent":
+          events.push({
+            type: "unlabeled",
+            actor,
+            timestamp,
+            details: node.label?.name
+          });
+          break;
+        case "AssignedEvent":
+          events.push({
+            type: "assigned",
+            actor,
+            timestamp,
+            details: node.assignee?.login
+          });
+          break;
+        case "UnassignedEvent":
+          events.push({
+            type: "unassigned",
+            actor,
+            timestamp,
+            details: node.assignee?.login
+          });
+          break;
+        case "ClosedEvent":
+          events.push({ type: "closed", actor, timestamp });
+          break;
+        case "ReopenedEvent":
+          events.push({ type: "reopened", actor, timestamp });
+          break;
+        case "CrossReferencedEvent": {
+          const source = node.source;
+          if (source) {
+            const ref = source.__typename === "PullRequest" ? `PR #${source.number}: ${source.title}` : `#${source.number}: ${source.title}`;
+            events.push({
+              type: "referenced",
+              actor,
+              timestamp,
+              details: ref
+            });
+          }
+          break;
+        }
+      }
+    }
+    return events;
+  }
 };
 
 // src/branch-linker.ts
@@ -3637,6 +3900,106 @@ function validateUrl(url) {
   return url;
 }
 
+// src/standup.ts
+function formatStandupText(activities, options) {
+  const { since } = options;
+  const lines = [];
+  const sinceStr = formatRelativeDate(since);
+  const issueCount = activities.length;
+  lines.push(`Since ${sinceStr} \u2014 ${issueCount} issue${issueCount !== 1 ? "s" : ""} changed`);
+  lines.push("");
+  if (activities.length === 0) {
+    lines.push("No activity found in this time window.");
+    return lines.join("\n");
+  }
+  for (const activity of activities) {
+    const statusTag = activity.status ? ` [${activity.status}]` : "";
+    lines.push(`#${activity.issue.number} ${activity.issue.title}${statusTag}`);
+    for (const event of activity.changes) {
+      lines.push(`  ${formatEventLine(event)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+function parseSince(input) {
+  const isoDate = new Date(input);
+  if (!isNaN(isoDate.getTime()) && input.includes("-")) {
+    return isoDate;
+  }
+  const match = input.match(/^(\d+)\s*(h|d|w)$/i);
+  if (!match) {
+    throw new Error(`Invalid duration format: "${input}". Use formats like "24h", "2d", "1w", or an ISO date.`);
+  }
+  const amount = parseInt(match[1], 10);
+  const unit = match[2].toLowerCase();
+  const now = /* @__PURE__ */ new Date();
+  switch (unit) {
+    case "h":
+      return new Date(now.getTime() - amount * 60 * 60 * 1e3);
+    case "d":
+      return new Date(now.getTime() - amount * 24 * 60 * 60 * 1e3);
+    case "w":
+      return new Date(now.getTime() - amount * 7 * 24 * 60 * 60 * 1e3);
+    default:
+      throw new Error(`Unknown duration unit: "${unit}"`);
+  }
+}
+function formatEventLine(event) {
+  const arrow = "\u2197";
+  const timestamp = formatShortTimestamp(event.timestamp);
+  const actor = event.actor;
+  switch (event.type) {
+    case "comment":
+      return `${arrow} Comment by ${actor} (${timestamp})${event.details ? ": " + event.details : ""}`;
+    case "labeled":
+      return `${arrow} Labeled "${event.details}" by ${actor} (${timestamp})`;
+    case "unlabeled":
+      return `${arrow} Unlabeled "${event.details}" by ${actor} (${timestamp})`;
+    case "assigned":
+      return `${arrow} Assigned to ${event.details || actor} (${timestamp})`;
+    case "unassigned":
+      return `${arrow} Unassigned ${event.details || ""} by ${actor} (${timestamp})`;
+    case "closed":
+      return `${arrow} Closed by ${actor} (${timestamp})`;
+    case "reopened":
+      return `${arrow} Reopened by ${actor} (${timestamp})`;
+    case "referenced":
+      return `${arrow} ${event.details} linked by ${actor} (${timestamp})`;
+    default:
+      return `${arrow} ${event.type} by ${actor} (${timestamp})`;
+  }
+}
+function formatRelativeDate(date) {
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffHours = Math.round(diffMs / (1e3 * 60 * 60));
+  const dateStr = date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+  if (diffHours < 24) {
+    return `${diffHours}h ago (${dateStr})`;
+  } else if (diffHours < 48) {
+    return `yesterday (${dateStr})`;
+  } else {
+    const diffDays = Math.round(diffHours / 24);
+    return `${diffDays} days ago (${dateStr})`;
+  }
+}
+function formatShortTimestamp(isoTimestamp) {
+  if (!isoTimestamp) return "";
+  const date = new Date(isoTimestamp);
+  return date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+
 // src/dashboard/index.ts
 import { exec as exec3 } from "child_process";
 import { promisify as promisify3 } from "util";
@@ -5093,6 +5456,7 @@ export {
   findSessionFile,
   formatAction,
   formatConflict,
+  formatStandupText,
   gatherDashboardData,
   generateBranchName,
   generateWorktreePath,
@@ -5150,6 +5514,7 @@ export {
   parseIssueUrl,
   parseRateLimitDelay,
   parseSessionLine,
+  parseSince,
   pullLatest,
   queries_exports as queries,
   registerAgent,

package/package.json

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