ci: tolerate perf comment write failures

Make the perf comment helper fall back to creating a new comment when updating the existing marker comment fails. If GitHub refuses comment writes, as it does for fork pull_request tokens, log a warning and let the performance comparison job finish successfully.

Validation: pnpm run format; pnpm typecheck

Author: ryoppippi

.github/scripts/upsert-pr-comment.ts

@@ -8,6 +8,16 @@ type GitHubComment = {
 	};
 };
 
+class GitHubRequestError extends Error {
+	constructor(
+		message: string,
+		readonly status: number,
+	) {
+		super(message);
+		this.name = 'GitHubRequestError';
+	}
+}
+
 function requiredEnv(name: string): string {
 	const value = Bun.env[name];
 	if (value == null || value.length === 0) {
@@ -29,8 +39,9 @@ async function githubRequest<T>(path: string, options: RequestInit = {}): Promis
 	});
 
 	if (!response.ok) {
-		throw new Error(
+		throw new GitHubRequestError(
 			`${options.method ?? 'GET'} ${path} failed: ${response.status} ${await response.text()}`,
+			response.status,
 		);
 	}
 
@@ -46,6 +57,27 @@ const prNumber = requiredEnv('PR_NUMBER');
 const marker = requiredEnv('COMMENT_MARKER');
 const body = await Bun.file(requiredEnv('COMMENT_FILE')).text();
 
+async function createComment(): Promise<void> {
+	await githubRequest(`/repos/${repository}/issues/${prNumber}/comments`, {
+		method: 'POST',
+		body: JSON.stringify({ body }),
+	});
+}
+
+async function tryCreateComment(): Promise<void> {
+	try {
+		await createComment();
+	} catch (error) {
+		if (error instanceof GitHubRequestError && error.status === 403) {
+			console.warn(
+				`Skipping PR comment because GitHub token cannot write comments: ${error.message}`,
+			);
+			return;
+		}
+		throw error;
+	}
+}
+
 const comments = await githubRequest<GitHubComment[]>(
 	`/repos/${repository}/issues/${prNumber}/comments?per_page=100`,
 );
@@ -54,13 +86,16 @@ const existing = comments.find(
 );
 
 if (existing == null) {
-	await githubRequest(`/repos/${repository}/issues/${prNumber}/comments`, {
-		method: 'POST',
-		body: JSON.stringify({ body }),
-	});
+	await tryCreateComment();
 } else {
-	await githubRequest(`/repos/${repository}/issues/comments/${existing.id}`, {
-		method: 'PATCH',
-		body: JSON.stringify({ body }),
-	});
+	try {
+		await githubRequest(`/repos/${repository}/issues/comments/${existing.id}`, {
+			method: 'PATCH',
+			body: JSON.stringify({ body }),
+		});
+	} catch (error) {
+		console.warn(`Failed to update existing PR comment; creating a new comment instead.`);
+		console.warn(error);
+		await tryCreateComment();
+	}
 }

.github/workflows/ccusage-perf.yaml

@@ -59,6 +59,9 @@ jobs:
             --large-runs 1 \
             --output "$RUNNER_TEMP/ccusage-perf-comment.md"
 
+      - name: Write job summary
+        run: cat "$RUNNER_TEMP/ccusage-perf-comment.md" >> "$GITHUB_STEP_SUMMARY"
+
       - name: Upsert PR comment
         env:
           COMMENT_FILE: ${{ runner.temp }}/ccusage-perf-comment.md