Add GitHub-to-Buzz issue automation (#11345)
This commit is contained in:
Douwe Osinga
Executable
+928
@@ -0,0 +1,928 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
import {
|
||||
accessSync,
|
||||
chmodSync,
|
||||
constants,
|
||||
existsSync,
|
||||
readFileSync,
|
||||
renameSync,
|
||||
writeFileSync,
|
||||
} from "node:fs";
|
||||
import { homedir } from "node:os";
|
||||
import { dirname, join } from "node:path";
|
||||
import { spawnSync } from "node:child_process";
|
||||
import { fileURLToPath } from "node:url";
|
||||
|
||||
import {
|
||||
getOpenIssues,
|
||||
getProjectIssues,
|
||||
issueReferenceFromChannel,
|
||||
issueReferenceRank,
|
||||
readCoreTeam,
|
||||
} from "./github_manager.mjs";
|
||||
|
||||
const phaseMarkers = {
|
||||
Inbox: "⚪",
|
||||
"Needs info": "🟡",
|
||||
"Accepted / design": "🟣",
|
||||
Ready: "🟢",
|
||||
Verification: "🔵",
|
||||
Done: "✅",
|
||||
};
|
||||
const internalAuthorAssociations = new Set([
|
||||
"OWNER",
|
||||
"MEMBER",
|
||||
"COLLABORATOR",
|
||||
]);
|
||||
const scriptDirectory = dirname(fileURLToPath(import.meta.url));
|
||||
|
||||
const options = parseArguments(process.argv.slice(2));
|
||||
if (options.help) {
|
||||
printHelp();
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
const relayUrl = process.env.BUZZ_RELAY_URL || "https://buzz.gdk.so";
|
||||
const configHome = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
|
||||
const buzzHome =
|
||||
process.env.GOOSE_BUZZ_HOME || join(configHome, "goose", "buzz");
|
||||
const identityDirectory = join(buzzHome, "github-manager");
|
||||
const privateKeyPath = join(identityDirectory, "private-key.nsec");
|
||||
const publicKeyPath = join(identityDirectory, "public-key.hex");
|
||||
const commentStatePath = join(
|
||||
identityDirectory,
|
||||
`issue-comment-sync-${options.repository
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, "-")}.json`,
|
||||
);
|
||||
const snoozeStatePath = join(
|
||||
identityDirectory,
|
||||
`issue-snooze-sync-${options.repository
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, "-")}.json`,
|
||||
);
|
||||
const coreTeamPath =
|
||||
process.env.BUZZ_CORE_TEAM_FILE || join(scriptDirectory, "core-team.json");
|
||||
const privateKey = readRequiredFile(privateKeyPath);
|
||||
const publicKey = readRequiredFile(publicKeyPath).toLowerCase();
|
||||
if (!/^[0-9a-f]{64}$/.test(publicKey)) {
|
||||
fail(`Invalid GitHub Manager public key in ${publicKeyPath}.`);
|
||||
}
|
||||
const buzz = findBuzz();
|
||||
const gh = process.env.GH_BIN || "gh";
|
||||
const buzzEnvironment = {
|
||||
...process.env,
|
||||
BUZZ_PRIVATE_KEY: privateKey,
|
||||
BUZZ_RELAY_URL: relayUrl,
|
||||
};
|
||||
const coreTeam = readCoreTeamOrFail();
|
||||
const coreTeamByGithub = coreTeam.byGithub;
|
||||
const { byNumber: projectItemsByIssueNumber } = getProjectIssuesOrFail();
|
||||
const openIssues = getOpenIssuesOrFail();
|
||||
const openIssueCount = openIssues.length;
|
||||
|
||||
const openIssuesByNumber = new Map(
|
||||
openIssues.map((issue) => [issue.number, issue]),
|
||||
);
|
||||
const detailsByChannelId = getChannelDetails();
|
||||
const channels = [...detailsByChannelId.values()];
|
||||
const results = [];
|
||||
const channelsByIssueNumber = new Map();
|
||||
const channelOwnership = new Map();
|
||||
const githubItemKinds = new Map();
|
||||
const selectedChannels = new Map();
|
||||
|
||||
for (const channel of channels) {
|
||||
const resolved = resolveChannel(channel);
|
||||
if (!resolved) {
|
||||
continue;
|
||||
}
|
||||
if (!resolved.number) {
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
state: "IGNORED",
|
||||
actions: ["skipped"],
|
||||
reason: resolved.reason,
|
||||
});
|
||||
continue;
|
||||
}
|
||||
const selected = selectedChannels.get(resolved.number);
|
||||
if (!selected) {
|
||||
selectedChannels.set(resolved.number, { channel, resolved });
|
||||
continue;
|
||||
}
|
||||
if (selected.resolved.rank === resolved.rank) {
|
||||
fail(`More than one Buzz channel matches GitHub issue #${resolved.number}.`);
|
||||
}
|
||||
const ignored =
|
||||
selected.resolved.rank > resolved.rank ? channel : selected.channel;
|
||||
results.push({
|
||||
channel_id: ignored.channel_id,
|
||||
channel: ignored.name,
|
||||
issue: resolved.number,
|
||||
state: "IGNORED",
|
||||
actions: ["skipped"],
|
||||
reason: "A more specific issue channel exists",
|
||||
});
|
||||
if (resolved.rank > selected.resolved.rank) {
|
||||
selectedChannels.set(resolved.number, { channel, resolved });
|
||||
}
|
||||
}
|
||||
|
||||
for (const { channel, resolved } of selectedChannels.values()) {
|
||||
const issueNumber = resolved.number;
|
||||
channelsByIssueNumber.set(issueNumber, channel);
|
||||
|
||||
const details = detailsByChannelId.get(channel.channel_id);
|
||||
if (!details) {
|
||||
fail(`Could not read state for Buzz channel ${channel.channel_id}.`);
|
||||
}
|
||||
|
||||
const actions = [];
|
||||
const currentTopic = details.topic || null;
|
||||
const issue = openIssuesByNumber.get(issueNumber);
|
||||
|
||||
if (!issue) {
|
||||
const topic = "✅ GitHub issue: Closed";
|
||||
const topicNeedsUpdate = currentTopic !== topic;
|
||||
if (
|
||||
(!details.archived || topicNeedsUpdate) &&
|
||||
!canManageChannel(channel.channel_id)
|
||||
) {
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
issue: issueNumber,
|
||||
state: "CLOSED",
|
||||
topic: currentTopic,
|
||||
desired_topic: topic,
|
||||
actions: ["skipped-not-owner"],
|
||||
reason: "GitHub Manager is not a channel owner",
|
||||
});
|
||||
continue;
|
||||
}
|
||||
if (details.archived && topicNeedsUpdate) {
|
||||
if (!options.dryRun) {
|
||||
runBuzz(["channels", "unarchive", "--channel", channel.channel_id]);
|
||||
}
|
||||
actions.push(options.dryRun ? "would-unarchive" : "unarchived");
|
||||
}
|
||||
if (topicNeedsUpdate) {
|
||||
if (!options.dryRun) {
|
||||
runBuzz([
|
||||
"channels",
|
||||
"topic",
|
||||
"--channel",
|
||||
channel.channel_id,
|
||||
"--topic",
|
||||
topic,
|
||||
]);
|
||||
}
|
||||
actions.push(options.dryRun ? "would-update-topic" : "topic-updated");
|
||||
}
|
||||
if (!details.archived || topicNeedsUpdate) {
|
||||
if (!options.dryRun) {
|
||||
runBuzz(["channels", "archive", "--channel", channel.channel_id]);
|
||||
}
|
||||
actions.push(options.dryRun ? "would-archive" : "archived");
|
||||
}
|
||||
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
issue: issueNumber,
|
||||
state: "CLOSED",
|
||||
topic,
|
||||
...(topicNeedsUpdate ? { previous_topic: currentTopic } : {}),
|
||||
actions: actions.length > 0 ? actions : ["unchanged"],
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
if (details.archived) {
|
||||
if (!canManageChannel(channel.channel_id)) {
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
issue: issue.number,
|
||||
state: "OPEN",
|
||||
topic: currentTopic,
|
||||
actions: ["skipped-not-owner"],
|
||||
reason: "GitHub Manager is not a channel owner",
|
||||
});
|
||||
continue;
|
||||
}
|
||||
if (!options.dryRun) {
|
||||
runBuzz(["channels", "unarchive", "--channel", channel.channel_id]);
|
||||
}
|
||||
actions.push(options.dryRun ? "would-unarchive" : "unarchived");
|
||||
}
|
||||
|
||||
const projectItem = projectItemsByIssueNumber.get(issue.number);
|
||||
const phase = projectItem?.status;
|
||||
if (!phase) {
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
issue: issue.number,
|
||||
state: "OPEN",
|
||||
actions: actions.length > 0 ? actions : ["skipped"],
|
||||
reason: `Issue is not in ${options.project} with a status`,
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
const marker = phaseMarkers[phase];
|
||||
const assignees = issue.assignees
|
||||
.map((assignee) => assignee.login)
|
||||
.filter(Boolean);
|
||||
const assignment =
|
||||
assignees.length > 0
|
||||
? assignees.map((login) => `@${login}`).join(", ")
|
||||
: "unassigned";
|
||||
const topic = `${marker ? `${marker} ` : ""}${phase} -- assigned to: ${assignment}`;
|
||||
|
||||
if (currentTopic !== topic && !canManageChannel(channel.channel_id)) {
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
issue: issue.number,
|
||||
state: "OPEN",
|
||||
phase,
|
||||
assignees,
|
||||
topic: currentTopic,
|
||||
desired_topic: topic,
|
||||
actions: ["skipped-not-owner"],
|
||||
reason: "GitHub Manager is not a channel owner",
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
if (currentTopic !== topic) {
|
||||
if (!options.dryRun) {
|
||||
runBuzz([
|
||||
"channels",
|
||||
"topic",
|
||||
"--channel",
|
||||
channel.channel_id,
|
||||
"--topic",
|
||||
topic,
|
||||
]);
|
||||
}
|
||||
actions.push(options.dryRun ? "would-update-topic" : "topic-updated");
|
||||
}
|
||||
|
||||
results.push({
|
||||
channel_id: channel.channel_id,
|
||||
channel: channel.name,
|
||||
issue: issue.number,
|
||||
state: "OPEN",
|
||||
phase,
|
||||
assignees,
|
||||
topic,
|
||||
...(currentTopic !== topic ? { previous_topic: currentTopic } : {}),
|
||||
actions: actions.length > 0 ? actions : ["unchanged"],
|
||||
});
|
||||
}
|
||||
|
||||
const commentSync = syncOutsiderComments(
|
||||
openIssuesByNumber,
|
||||
channelsByIssueNumber,
|
||||
);
|
||||
const snoozeSync = syncExpiredSnoozes(
|
||||
openIssuesByNumber,
|
||||
channelsByIssueNumber,
|
||||
);
|
||||
|
||||
console.log(
|
||||
JSON.stringify(
|
||||
{
|
||||
repository: options.repository,
|
||||
project: options.project,
|
||||
dry_run: options.dryRun,
|
||||
open_github_issues: openIssueCount,
|
||||
buzz_channels: channels.length,
|
||||
matched_channels: results.length,
|
||||
comment_sync: commentSync,
|
||||
snooze_sync: snoozeSync,
|
||||
channels: results,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
),
|
||||
);
|
||||
|
||||
function parseArguments(arguments_) {
|
||||
const parsed = {
|
||||
repository: "aaif-goose/goose",
|
||||
project: "Goose Issues",
|
||||
projectOwner: "aaif-goose",
|
||||
projectNumber: 1,
|
||||
projectLimit: 1000,
|
||||
limit: 500,
|
||||
dryRun: false,
|
||||
help: false,
|
||||
};
|
||||
|
||||
for (let index = 0; index < arguments_.length; index += 1) {
|
||||
const argument = arguments_[index];
|
||||
|
||||
if (argument === "--repo") {
|
||||
parsed.repository = requiredValue(arguments_, ++index, argument);
|
||||
continue;
|
||||
}
|
||||
if (argument === "--project") {
|
||||
parsed.project = requiredValue(arguments_, ++index, argument);
|
||||
continue;
|
||||
}
|
||||
if (argument === "--project-owner") {
|
||||
parsed.projectOwner = requiredValue(arguments_, ++index, argument);
|
||||
continue;
|
||||
}
|
||||
if (argument === "--project-number") {
|
||||
parsed.projectNumber = positiveInteger(
|
||||
requiredValue(arguments_, ++index, argument),
|
||||
argument,
|
||||
);
|
||||
continue;
|
||||
}
|
||||
if (argument === "--project-limit") {
|
||||
parsed.projectLimit = positiveInteger(
|
||||
requiredValue(arguments_, ++index, argument),
|
||||
argument,
|
||||
);
|
||||
continue;
|
||||
}
|
||||
if (argument === "--limit") {
|
||||
const value = Number.parseInt(
|
||||
requiredValue(arguments_, ++index, argument),
|
||||
10,
|
||||
);
|
||||
if (!Number.isSafeInteger(value) || value < 1) {
|
||||
fail("--limit must be a positive integer.");
|
||||
}
|
||||
parsed.limit = value;
|
||||
continue;
|
||||
}
|
||||
if (argument === "--dry-run") {
|
||||
parsed.dryRun = true;
|
||||
continue;
|
||||
}
|
||||
if (argument === "--help" || argument === "-h") {
|
||||
parsed.help = true;
|
||||
continue;
|
||||
}
|
||||
fail(`Unknown option: ${argument}`);
|
||||
}
|
||||
|
||||
return parsed;
|
||||
}
|
||||
|
||||
function requiredValue(arguments_, index, option) {
|
||||
const value = arguments_[index];
|
||||
if (!value || value.startsWith("--")) {
|
||||
fail(`${option} requires a value.`);
|
||||
}
|
||||
return value;
|
||||
}
|
||||
|
||||
function positiveInteger(value, option) {
|
||||
const parsed = Number.parseInt(value, 10);
|
||||
if (!Number.isSafeInteger(parsed) || parsed < 1) {
|
||||
fail(`${option} must be a positive integer.`);
|
||||
}
|
||||
return parsed;
|
||||
}
|
||||
|
||||
function getProjectIssuesOrFail() {
|
||||
try {
|
||||
return getProjectIssues(runJson, {
|
||||
command: gh,
|
||||
projectNumber: options.projectNumber,
|
||||
projectOwner: options.projectOwner,
|
||||
projectLimit: options.projectLimit,
|
||||
repository: options.repository,
|
||||
});
|
||||
} catch (error) {
|
||||
fail(error.message);
|
||||
}
|
||||
}
|
||||
|
||||
function getOpenIssuesOrFail() {
|
||||
try {
|
||||
return getOpenIssues(runJson, {
|
||||
command: gh,
|
||||
repository: options.repository,
|
||||
});
|
||||
} catch (error) {
|
||||
fail(error.message);
|
||||
}
|
||||
}
|
||||
|
||||
function readCoreTeamOrFail() {
|
||||
try {
|
||||
return readCoreTeam(coreTeamPath);
|
||||
} catch (error) {
|
||||
fail(error.message);
|
||||
}
|
||||
}
|
||||
|
||||
function getChannelDetails() {
|
||||
const details = new Map();
|
||||
for (const digit of "0123456789") {
|
||||
const matches = runBuzz([
|
||||
"channels",
|
||||
"search",
|
||||
"--query",
|
||||
digit,
|
||||
"--include-archived",
|
||||
"--limit",
|
||||
String(options.limit),
|
||||
]);
|
||||
if (matches.length >= options.limit) {
|
||||
fail(
|
||||
`Buzz returned ${matches.length} channels at the --limit boundary for ${digit}. Raise --limit.`,
|
||||
);
|
||||
}
|
||||
for (const channel of matches) {
|
||||
details.set(channel.channel_id, channel);
|
||||
}
|
||||
}
|
||||
return details;
|
||||
}
|
||||
|
||||
function canManageChannel(channelId) {
|
||||
if (!channelOwnership.has(channelId)) {
|
||||
const members = runBuzz([
|
||||
"channels",
|
||||
"members",
|
||||
"--channel",
|
||||
channelId,
|
||||
]);
|
||||
channelOwnership.set(
|
||||
channelId,
|
||||
members.some(
|
||||
(member) =>
|
||||
member.pubkey?.toLowerCase() === publicKey && member.role === "owner",
|
||||
),
|
||||
);
|
||||
}
|
||||
return channelOwnership.get(channelId);
|
||||
}
|
||||
|
||||
function resolveChannel(channel) {
|
||||
const reference = issueReferenceFromChannel(channel);
|
||||
if (!reference) {
|
||||
return null;
|
||||
}
|
||||
if (
|
||||
reference.repository &&
|
||||
reference.repository.toLowerCase() !== options.repository.toLowerCase()
|
||||
) {
|
||||
return {
|
||||
reason: `Channel belongs to ${reference.repository}#${reference.number}`,
|
||||
};
|
||||
}
|
||||
if (reference.kind === "pull-request") {
|
||||
return { reason: `#${reference.number} is a pull request, not an issue` };
|
||||
}
|
||||
const rank = issueReferenceRank(reference);
|
||||
if (
|
||||
reference.source === "description" ||
|
||||
projectItemsByIssueNumber.has(reference.number) ||
|
||||
openIssuesByNumber.has(reference.number)
|
||||
) {
|
||||
return { number: reference.number, rank };
|
||||
}
|
||||
|
||||
const kind = githubItemKind(reference.number);
|
||||
return kind === "issue"
|
||||
? { number: reference.number, rank }
|
||||
: {
|
||||
reason:
|
||||
kind === "pull-request"
|
||||
? `#${reference.number} is a pull request, not an issue`
|
||||
: `Could not find GitHub issue #${reference.number}`,
|
||||
};
|
||||
}
|
||||
|
||||
function githubItemKind(number) {
|
||||
if (!githubItemKinds.has(number)) {
|
||||
const item = runOptionalJson(gh, [
|
||||
"api",
|
||||
`repos/${options.repository}/issues/${number}`,
|
||||
]);
|
||||
githubItemKinds.set(
|
||||
number,
|
||||
item ? (item.pull_request ? "pull-request" : "issue") : "missing",
|
||||
);
|
||||
}
|
||||
return githubItemKinds.get(number);
|
||||
}
|
||||
|
||||
function runOptionalJson(command, arguments_) {
|
||||
const result = spawnSync(command, arguments_, {
|
||||
encoding: "utf8",
|
||||
maxBuffer: 32 * 1024 * 1024,
|
||||
});
|
||||
if (result.error) {
|
||||
fail(`Could not run ${command}: ${result.error.message}`);
|
||||
}
|
||||
if (result.status !== 0) {
|
||||
const message = result.stderr.trim() || result.stdout.trim();
|
||||
if (/HTTP 404|Not Found/i.test(message)) {
|
||||
return null;
|
||||
}
|
||||
fail(`${command} failed${message ? `: ${message}` : "."}`);
|
||||
}
|
||||
try {
|
||||
return JSON.parse(result.stdout);
|
||||
} catch {
|
||||
fail(`${command} returned invalid JSON: ${result.stdout.trim()}`);
|
||||
}
|
||||
}
|
||||
|
||||
function syncOutsiderComments(openIssuesByNumber, channelsByIssueNumber) {
|
||||
const syncStartedAt = new Date(
|
||||
Math.floor(Date.now() / 1000) * 1000,
|
||||
).toISOString();
|
||||
const state = readCommentState();
|
||||
|
||||
if (!state) {
|
||||
if (!options.dryRun) {
|
||||
writeCommentState({ checked_at: syncStartedAt, posted_comment_ids: [] });
|
||||
}
|
||||
return {
|
||||
status: options.dryRun ? "would-initialize" : "initialized",
|
||||
checked_at: syncStartedAt,
|
||||
comments_scanned: 0,
|
||||
notifications: [],
|
||||
};
|
||||
}
|
||||
|
||||
const pages = runJson(gh, [
|
||||
"api",
|
||||
"--method",
|
||||
"GET",
|
||||
"--paginate",
|
||||
"--slurp",
|
||||
`repos/${options.repository}/issues/comments`,
|
||||
"-f",
|
||||
`since=${state.checked_at}`,
|
||||
"-f",
|
||||
"per_page=100",
|
||||
]);
|
||||
if (!Array.isArray(pages) || pages.some((page) => !Array.isArray(page))) {
|
||||
fail("GitHub returned an invalid paginated issue comment response.");
|
||||
}
|
||||
|
||||
const comments = pages
|
||||
.flat()
|
||||
.filter((comment) => {
|
||||
const createdAt = Date.parse(comment.created_at);
|
||||
return (
|
||||
Number.isFinite(createdAt) &&
|
||||
createdAt >= Date.parse(state.checked_at) &&
|
||||
createdAt <= Date.parse(syncStartedAt)
|
||||
);
|
||||
})
|
||||
.sort(
|
||||
(left, right) =>
|
||||
Date.parse(left.created_at) - Date.parse(right.created_at) ||
|
||||
left.id - right.id,
|
||||
);
|
||||
const postedCommentIds = new Set(state.posted_comment_ids);
|
||||
const notifications = [];
|
||||
|
||||
for (const comment of comments) {
|
||||
if (
|
||||
!comment.user ||
|
||||
comment.user.type !== "User" ||
|
||||
internalAuthorAssociations.has(comment.author_association)
|
||||
) {
|
||||
continue;
|
||||
}
|
||||
|
||||
const issueNumber = issueNumberFromApiUrl(comment.issue_url);
|
||||
if (!issueNumber || !openIssuesByNumber.has(issueNumber)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
const channel = channelsByIssueNumber.get(issueNumber);
|
||||
if (!channel) {
|
||||
notifications.push({
|
||||
issue: issueNumber,
|
||||
comment_id: comment.id,
|
||||
author: comment.user.login,
|
||||
url: comment.html_url,
|
||||
action: "skipped-no-channel",
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
if (postedCommentIds.has(comment.id)) {
|
||||
notifications.push({
|
||||
issue: issueNumber,
|
||||
channel_id: channel.channel_id,
|
||||
comment_id: comment.id,
|
||||
author: comment.user.login,
|
||||
url: comment.html_url,
|
||||
action: "already-notified",
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
const issue = openIssuesByNumber.get(issueNumber);
|
||||
const owner = issueOwner(issue);
|
||||
if (!options.dryRun) {
|
||||
const content = [
|
||||
owner
|
||||
? `@${owner.name}, \`${comment.user.login}\` replied on GitHub.`
|
||||
: `\`${comment.user.login}\` replied on GitHub. This issue has no core-team owner to mention.`,
|
||||
"",
|
||||
`[Read the reply on GitHub](${comment.html_url})`,
|
||||
].join("\n");
|
||||
const sendArguments = [
|
||||
"messages",
|
||||
"send",
|
||||
"--channel",
|
||||
channel.channel_id,
|
||||
"--content",
|
||||
content,
|
||||
];
|
||||
if (owner) {
|
||||
sendArguments.push("--mention", owner.pubkey);
|
||||
}
|
||||
runBuzz(sendArguments);
|
||||
postedCommentIds.add(comment.id);
|
||||
writeCommentState({
|
||||
checked_at: state.checked_at,
|
||||
posted_comment_ids: [...postedCommentIds],
|
||||
});
|
||||
}
|
||||
|
||||
notifications.push({
|
||||
issue: issueNumber,
|
||||
channel_id: channel.channel_id,
|
||||
comment_id: comment.id,
|
||||
author: comment.user.login,
|
||||
url: comment.html_url,
|
||||
owner: owner?.github || null,
|
||||
action: options.dryRun ? "would-notify" : "notified",
|
||||
});
|
||||
}
|
||||
|
||||
if (!options.dryRun) {
|
||||
const boundaryCommentIds = comments
|
||||
.filter(
|
||||
(comment) =>
|
||||
Date.parse(comment.created_at) === Date.parse(syncStartedAt) &&
|
||||
postedCommentIds.has(comment.id),
|
||||
)
|
||||
.map((comment) => comment.id);
|
||||
writeCommentState({
|
||||
checked_at: syncStartedAt,
|
||||
posted_comment_ids: boundaryCommentIds,
|
||||
});
|
||||
}
|
||||
|
||||
return {
|
||||
status: "scanned",
|
||||
since: state.checked_at,
|
||||
checked_at: syncStartedAt,
|
||||
comments_scanned: comments.length,
|
||||
notifications,
|
||||
};
|
||||
}
|
||||
|
||||
function syncExpiredSnoozes(openIssuesByNumber, channelsByIssueNumber) {
|
||||
const state = readSnoozeState();
|
||||
const today = localDate(new Date());
|
||||
const notifications = [];
|
||||
|
||||
for (const [issueNumber, channel] of channelsByIssueNumber) {
|
||||
const issue = openIssuesByNumber.get(issueNumber);
|
||||
const projectItem = projectItemsByIssueNumber.get(issueNumber);
|
||||
const snoozedUntil = projectItem?.["snoozed until"];
|
||||
if (
|
||||
!issue ||
|
||||
typeof snoozedUntil !== "string" ||
|
||||
!/^\d{4}-\d{2}-\d{2}$/.test(snoozedUntil) ||
|
||||
snoozedUntil > today
|
||||
) {
|
||||
continue;
|
||||
}
|
||||
|
||||
const stateKey = String(issueNumber);
|
||||
if (state.notified[stateKey] === snoozedUntil) {
|
||||
continue;
|
||||
}
|
||||
|
||||
const owner = issueOwner(issue);
|
||||
if (!options.dryRun) {
|
||||
const content = owner
|
||||
? `@${owner.name}, the snooze is expired.`
|
||||
: "The snooze is expired. This issue has no core-team owner to mention.";
|
||||
const sendArguments = [
|
||||
"messages",
|
||||
"send",
|
||||
"--channel",
|
||||
channel.channel_id,
|
||||
"--content",
|
||||
content,
|
||||
];
|
||||
if (owner) {
|
||||
sendArguments.push("--mention", owner.pubkey);
|
||||
}
|
||||
runBuzz(sendArguments);
|
||||
state.notified[stateKey] = snoozedUntil;
|
||||
writeSnoozeState(state);
|
||||
}
|
||||
|
||||
notifications.push({
|
||||
issue: issueNumber,
|
||||
channel_id: channel.channel_id,
|
||||
snoozed_until: snoozedUntil,
|
||||
owner: owner?.github || null,
|
||||
action: options.dryRun ? "would-notify" : "notified",
|
||||
});
|
||||
}
|
||||
|
||||
return { checked_on: today, notifications };
|
||||
}
|
||||
|
||||
function issueOwner(issue) {
|
||||
for (const assignee of issue.assignees || []) {
|
||||
const owner = coreTeamByGithub.get(assignee.login?.toLowerCase());
|
||||
if (owner) {
|
||||
return owner;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function localDate(date) {
|
||||
const year = date.getFullYear();
|
||||
const month = String(date.getMonth() + 1).padStart(2, "0");
|
||||
const day = String(date.getDate()).padStart(2, "0");
|
||||
return `${year}-${month}-${day}`;
|
||||
}
|
||||
|
||||
function issueNumberFromApiUrl(issueUrl) {
|
||||
const match = issueUrl?.match(/\/issues\/([1-9]\d*)$/);
|
||||
return match ? Number.parseInt(match[1], 10) : null;
|
||||
}
|
||||
|
||||
function readCommentState() {
|
||||
if (!existsSync(commentStatePath)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
chmodSync(commentStatePath, 0o600);
|
||||
let state;
|
||||
try {
|
||||
state = JSON.parse(readFileSync(commentStatePath, "utf8"));
|
||||
} catch (error) {
|
||||
fail(`Could not read ${commentStatePath}: ${error.message}`);
|
||||
}
|
||||
|
||||
if (
|
||||
typeof state.checked_at !== "string" ||
|
||||
!Number.isFinite(Date.parse(state.checked_at)) ||
|
||||
!Array.isArray(state.posted_comment_ids) ||
|
||||
state.posted_comment_ids.some((id) => !Number.isSafeInteger(id))
|
||||
) {
|
||||
fail(`Invalid issue comment sync state in ${commentStatePath}.`);
|
||||
}
|
||||
return state;
|
||||
}
|
||||
|
||||
function writeCommentState(state) {
|
||||
const temporaryPath = `${commentStatePath}.${process.pid}.tmp`;
|
||||
writeFileSync(temporaryPath, `${JSON.stringify(state, null, 2)}\n`, {
|
||||
mode: 0o600,
|
||||
});
|
||||
chmodSync(temporaryPath, 0o600);
|
||||
renameSync(temporaryPath, commentStatePath);
|
||||
chmodSync(commentStatePath, 0o600);
|
||||
}
|
||||
|
||||
function readSnoozeState() {
|
||||
if (!existsSync(snoozeStatePath)) {
|
||||
return { notified: {} };
|
||||
}
|
||||
|
||||
chmodSync(snoozeStatePath, 0o600);
|
||||
let state;
|
||||
try {
|
||||
state = JSON.parse(readFileSync(snoozeStatePath, "utf8"));
|
||||
} catch (error) {
|
||||
fail(`Could not read ${snoozeStatePath}: ${error.message}`);
|
||||
}
|
||||
if (
|
||||
!state.notified ||
|
||||
typeof state.notified !== "object" ||
|
||||
Array.isArray(state.notified) ||
|
||||
Object.entries(state.notified).some(
|
||||
([issue, date]) =>
|
||||
!/^[1-9]\d*$/.test(issue) ||
|
||||
typeof date !== "string" ||
|
||||
!/^\d{4}-\d{2}-\d{2}$/.test(date),
|
||||
)
|
||||
) {
|
||||
fail(`Invalid issue snooze sync state in ${snoozeStatePath}.`);
|
||||
}
|
||||
return state;
|
||||
}
|
||||
|
||||
function writeSnoozeState(state) {
|
||||
const temporaryPath = `${snoozeStatePath}.${process.pid}.tmp`;
|
||||
writeFileSync(temporaryPath, `${JSON.stringify(state, null, 2)}\n`, {
|
||||
mode: 0o600,
|
||||
});
|
||||
chmodSync(temporaryPath, 0o600);
|
||||
renameSync(temporaryPath, snoozeStatePath);
|
||||
chmodSync(snoozeStatePath, 0o600);
|
||||
}
|
||||
|
||||
function runBuzz(arguments_) {
|
||||
return runJson(buzz, arguments_, { env: buzzEnvironment });
|
||||
}
|
||||
|
||||
function runJson(command, arguments_, options = {}) {
|
||||
const result = spawnSync(command, arguments_, {
|
||||
encoding: "utf8",
|
||||
maxBuffer: 32 * 1024 * 1024,
|
||||
...options,
|
||||
});
|
||||
|
||||
if (result.error) {
|
||||
fail(`Could not run ${command}: ${result.error.message}`);
|
||||
}
|
||||
if (result.status !== 0) {
|
||||
const message = result.stderr.trim() || result.stdout.trim();
|
||||
fail(`${command} failed${message ? `: ${message}` : "."}`);
|
||||
}
|
||||
|
||||
try {
|
||||
return JSON.parse(result.stdout);
|
||||
} catch {
|
||||
fail(`${command} returned invalid JSON: ${result.stdout.trim()}`);
|
||||
}
|
||||
}
|
||||
|
||||
function findBuzz() {
|
||||
if (process.env.BUZZ_BIN) {
|
||||
return process.env.BUZZ_BIN;
|
||||
}
|
||||
|
||||
const bundledBuzz = "/Applications/Buzz.app/Contents/MacOS/buzz";
|
||||
try {
|
||||
accessSync(bundledBuzz, constants.X_OK);
|
||||
return bundledBuzz;
|
||||
} catch {
|
||||
return "buzz";
|
||||
}
|
||||
}
|
||||
|
||||
function readRequiredFile(path) {
|
||||
try {
|
||||
chmodSync(path, 0o600);
|
||||
return readFileSync(path, "utf8").trim();
|
||||
} catch (error) {
|
||||
fail(`Could not read ${path}: ${error.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
function fail(message) {
|
||||
console.error(message);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
function printHelp() {
|
||||
console.log(`Usage:
|
||||
syncissues [options]
|
||||
|
||||
Options:
|
||||
--repo <owner/repo> GitHub repository (default: aaif-goose/goose)
|
||||
--project <title> GitHub project title (default: Goose Issues)
|
||||
--project-owner <id> GitHub project owner (default: aaif-goose)
|
||||
--project-number <n> GitHub project number (default: 1)
|
||||
--project-limit <n> Maximum project items (default: 1000)
|
||||
--limit <number> Maximum Buzz channels to inspect (default: 500)
|
||||
--dry-run Print changes without updating Buzz
|
||||
-h, --help Show this help
|
||||
|
||||
Buzz displays stream channels with a leading # but stores that marker outside
|
||||
the channel name. Names beginning with an issue number are matched. The older
|
||||
aaif-goose/goose #<number> format is also supported. Open issues sync their
|
||||
project phase to the topic. Closed issues are archived; reopened issues are
|
||||
unarchived. Open issue topics include their GitHub assignees. New comments from
|
||||
GitHub users who are not repository owners, members, or collaborators post a
|
||||
notification in the matching open channel. The first non-dry run initializes
|
||||
the comment cursor without posting old comments. Reply notifications mention
|
||||
the issue's core-team assignee. Expired project snoozes also mention that owner
|
||||
once per snooze date.`);
|
||||
}
|
||||
Reference in New Issue
Block a user