Initial commit

src/github/operations/comments/common.ts

@@ -0,0 +1,33 @@
+import { GITHUB_SERVER_URL } from "../../api/config";
+
+export const SPINNER_HTML =
+  '<img src="https://github.com/user-attachments/assets/5ac382c7-e004-429b-8e35-7feb3e8f9c6f" width="14px" height="14px" style="vertical-align: middle; margin-left: 4px;" />';
+
+export function createJobRunLink(
+  owner: string,
+  repo: string,
+  runId: string,
+): string {
+  const jobRunUrl = `${GITHUB_SERVER_URL}/${owner}/${repo}/actions/runs/${runId}`;
+  return `[View job run](${jobRunUrl})`;
+}
+
+export function createBranchLink(
+  owner: string,
+  repo: string,
+  branchName: string,
+): string {
+  const branchUrl = `${GITHUB_SERVER_URL}/${owner}/${repo}/tree/${branchName}`;
+  return `\n[View branch](${branchUrl})`;
+}
+
+export function createCommentBody(
+  jobRunLink: string,
+  branchLink: string = "",
+): string {
+  return `Claude Code is working… ${SPINNER_HTML}
+
+I'll analyze this and get back to you.
+
+${jobRunLink}${branchLink}`;
+}

src/github/operations/comments/create-initial.ts

@@ -0,0 +1,73 @@
+#!/usr/bin/env bun
+
+/**
+ * Create the initial tracking comment when Claude Code starts working
+ * This comment shows the working status and includes a link to the job run
+ */
+
+import { appendFileSync } from "fs";
+import { createJobRunLink, createCommentBody } from "./common";
+import {
+  isPullRequestReviewCommentEvent,
+  type ParsedGitHubContext,
+} from "../../context";
+import type { Octokit } from "@octokit/rest";
+
+export async function createInitialComment(
+  octokit: Octokit,
+  context: ParsedGitHubContext,
+) {
+  const { owner, repo } = context.repository;
+
+  const jobRunLink = createJobRunLink(owner, repo, context.runId);
+  const initialBody = createCommentBody(jobRunLink);
+
+  try {
+    let response;
+
+    // Only use createReplyForReviewComment if it's a PR review comment AND we have a comment_id
+    if (isPullRequestReviewCommentEvent(context)) {
+      response = await octokit.rest.pulls.createReplyForReviewComment({
+        owner,
+        repo,
+        pull_number: context.entityNumber,
+        comment_id: context.payload.comment.id,
+        body: initialBody,
+      });
+    } else {
+      // For all other cases (issues, issue comments, or missing comment_id)
+      response = await octokit.rest.issues.createComment({
+        owner,
+        repo,
+        issue_number: context.entityNumber,
+        body: initialBody,
+      });
+    }
+
+    // Output the comment ID for downstream steps using GITHUB_OUTPUT
+    const githubOutput = process.env.GITHUB_OUTPUT!;
+    appendFileSync(githubOutput, `claude_comment_id=${response.data.id}\n`);
+    console.log(`✅ Created initial comment with ID: ${response.data.id}`);
+    return response.data.id;
+  } catch (error) {
+    console.error("Error in initial comment:", error);
+
+    // Always fall back to regular issue comment if anything fails
+    try {
+      const response = await octokit.rest.issues.createComment({
+        owner,
+        repo,
+        issue_number: context.entityNumber,
+        body: initialBody,
+      });
+
+      const githubOutput = process.env.GITHUB_OUTPUT!;
+      appendFileSync(githubOutput, `claude_comment_id=${response.data.id}\n`);
+      console.log(`✅ Created fallback comment with ID: ${response.data.id}`);
+      return response.data.id;
+    } catch (fallbackError) {
+      console.error("Error creating fallback comment:", fallbackError);
+      throw fallbackError;
+    }
+  }
+}

src/github/operations/comments/update-with-branch.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env bun
+
+/**
+ * Update the initial tracking comment with branch link
+ * This happens after the branch is created for issues
+ */
+
+import {
+  createJobRunLink,
+  createBranchLink,
+  createCommentBody,
+} from "./common";
+import { type Octokits } from "../../api/client";
+import {
+  isPullRequestReviewCommentEvent,
+  type ParsedGitHubContext,
+} from "../../context";
+
+export async function updateTrackingComment(
+  octokit: Octokits,
+  context: ParsedGitHubContext,
+  commentId: number,
+  branch?: string,
+) {
+  const { owner, repo } = context.repository;
+
+  const jobRunLink = createJobRunLink(owner, repo, context.runId);
+
+  // Add branch link for issues (not PRs)
+  let branchLink = "";
+  if (branch && !context.isPR) {
+    branchLink = createBranchLink(owner, repo, branch);
+  }
+
+  const updatedBody = createCommentBody(jobRunLink, branchLink);
+
+  // Update the existing comment with the branch link
+  try {
+    if (isPullRequestReviewCommentEvent(context)) {
+      // For PR review comments (inline comments), use the pulls API
+      await octokit.rest.pulls.updateReviewComment({
+        owner,
+        repo,
+        comment_id: commentId,
+        body: updatedBody,
+      });
+      console.log(`✅ Updated PR review comment ${commentId} with branch link`);
+    } else {
+      // For all other comments, use the issues API
+      await octokit.rest.issues.updateComment({
+        owner,
+        repo,
+        comment_id: commentId,
+        body: updatedBody,
+      });
+      console.log(`✅ Updated issue comment ${commentId} with branch link`);
+    }
+  } catch (error) {
+    console.error("Error updating comment with branch link:", error);
+    throw error;
+  }
+}