@ghfs/cli 0.1.0 → 0.2.0

package/dist/factory-UMSInaa_.mjs

@@ -0,0 +1,1166 @@
+import { defineDiagnostics } from "nostics";
+import { retry } from "@octokit/plugin-retry";
+import { throttling } from "@octokit/plugin-throttling";
+import { Octokit } from "octokit";
+//#region src/diagnostics/index.ts
+const diagnostics = defineDiagnostics({
+	docsBase: (code) => `https://github.com/antfu/ghfs/blob/main/docs/errors/${code.toLowerCase()}.md`,
+	codes: {
+		GHFS0001: {
+			why: "Missing GitHub token.",
+			fix: "Set GH_TOKEN or GITHUB_TOKEN, or run `gh auth login`."
+		},
+		GHFS0002: {
+			why: "Token prompt cancelled.",
+			fix: "Re-run the command and provide a token when prompted, or set GH_TOKEN/GITHUB_TOKEN."
+		},
+		GHFS0010: {
+			why: (p) => `Invalid --repo value: ${p.value}`,
+			fix: "Use `owner/name`, a full GitHub URL, or a git remote URL."
+		},
+		GHFS0011: {
+			why: (p) => `Invalid repo in ghfs.config.ts: ${p.value}`,
+			fix: "Use `owner/name`, a full GitHub URL, or a git remote URL."
+		},
+		GHFS0012: {
+			why: "Repository selection cancelled.",
+			fix: "Pass `--repo owner/name` or set `repo` in ghfs.config.ts to select non-interactively."
+		},
+		GHFS0013: {
+			why: (p) => `Invalid repository selection: ${p.value}`,
+			fix: "Pick one of the detected candidates or pass `--repo` explicitly."
+		},
+		GHFS0014: {
+			why: (p) => `Repo mismatch detected. git=${p.gitRepo} package.json=${p.pkgRepo}.`,
+			fix: "Use `--repo` to disambiguate."
+		},
+		GHFS0015: {
+			why: "Could not resolve repository.",
+			fix: "Provide `--repo` or set `repo` in ghfs.config.ts."
+		},
+		GHFS0016: {
+			why: (p) => `Invalid repo slug: ${p.repo}`,
+			fix: "Use the `owner/name` form."
+		},
+		GHFS0100: {
+			why: "Interactive execute prompts are unavailable.",
+			fix: "Use `--non-interactive` or provide prompts."
+		},
+		GHFS0101: {
+			why: (p) => `Operation conflict: remote updated_at=${p.remoteUpdatedAt}`,
+			fix: "Re-run `ghfs sync` to refresh tracked state, then retry the operation."
+		},
+		GHFS0102: { why: "Execution cancelled." },
+		GHFS0103: {
+			why: (p) => `Unsupported action: ${p.action}`,
+			fix: "Use one of the supported action names. See README for the list."
+		},
+		GHFS0104: { why: (p) => `Action ${p.action} requires ${p.issue} to be a pull request.` },
+		GHFS0105: {
+			why: (p) => `Failed to parse execute YAML: ${p.detail}`,
+			fix: "Check the YAML syntax in execute.yml."
+		},
+		GHFS0106: {
+			why: (p) => `Invalid execute file: ${p.detail}`,
+			fix: "Verify that every operation has the required fields and allowed types."
+		},
+		GHFS0107: {
+			why: (p) => `Invalid execute file: ${p.detail}`,
+			fix: "Use one of the supported action names."
+		},
+		GHFS0108: {
+			why: (p) => `Invalid execute file: ${p.detail}`,
+			fix: "Fix the listed rule violations and retry."
+		},
+		GHFS0150: { why: "invalid quoted string syntax" },
+		GHFS0151: { why: (p) => `unrecognized action pattern: ${p.command}` },
+		GHFS0152: { why: (p) => `${p.command} expects: ${p.syntax}` },
+		GHFS0153: { why: (p) => `${p.command} expects a single issue reference (#123)` },
+		GHFS0154: { why: (p) => `${p.command} requires at least one label` },
+		GHFS0155: { why: (p) => `${p.command} requires at least one assignee` },
+		GHFS0156: { why: (p) => `${p.command} requires a non-empty comment` },
+		GHFS0157: { why: (p) => `${p.command} expects one or more issue references (#123 #456)` },
+		GHFS0160: { why: (p) => `per-item: missing markdown for ${p.issue} (${p.path})` },
+		GHFS0161: { why: (p) => `per-item: invalid or missing frontmatter for ${p.issue}` },
+		GHFS0200: {
+			why: "A sync is already in progress.",
+			fix: "Wait for the current sync to finish, then retry."
+		},
+		GHFS0201: {
+			why: "An execute is already in progress.",
+			fix: "Wait for the current execute run to finish, then retry."
+		},
+		GHFS0202: { why: (p) => `Queue entry not found: ${p.id}` },
+		GHFS0203: { why: (p) => `Cannot remove a per-item edit from the queue. Edit ${p.target} directly to adjust it.` },
+		GHFS0204: { why: "execute.md not found; cannot remove op." },
+		GHFS0205: { why: (p) => `Cannot edit ${p.source} ops from the queue panel.` },
+		GHFS0206: { why: (p) => p.detail },
+		GHFS0300: { why: (p) => `Unexpected patch response for pull ${p.issue}.` },
+		GHFS0301: {
+			why: (p) => `Milestone not found: ${p.value}`,
+			fix: "Create the milestone on GitHub, or pass its numeric id."
+		},
+		GHFS0302: {
+			why: "Cannot remove a reaction without an authenticated user.",
+			fix: "Ensure GH_TOKEN/GITHUB_TOKEN is set so ghfs knows which user's reaction to remove."
+		},
+		GHFS0400: { why: "Sync context was not initialized." },
+		GHFS0401: { why: (p) => `Missing tracked canonical data for ${p.issue}.` }
+	}
+});
+//#endregion
+//#region src/logger.ts
+function formatInline(d) {
+	return `[${d.name}] ${d.message}`;
+}
+//#endregion
+//#region src/utils/repo.ts
+function splitRepo(repo) {
+	const [owner, name] = repo.split("/");
+	if (!owner || !name) throw diagnostics.GHFS0016({ repo });
+	return {
+		owner,
+		repo: name
+	};
+}
+//#endregion
+//#region src/utils/color.ts
+function randomHexColor() {
+	return Math.floor(Math.random() * 16777216).toString(16).padStart(6, "0");
+}
+//#endregion
+//#region src/utils/format.ts
+function formatIssueNumber(number, options = {}) {
+	const label = `#${number}`;
+	if (!options.repo) return label;
+	return formatTerminalLink(label, toGitHubIssueUrl(options.repo, number, options.kind));
+}
+function formatTerminalLink(text, url) {
+	return `\u001B]8;;${url}\u001B\\${text}\u001B]8;;\u001B\\`;
+}
+function toGitHubIssueUrl(repo, number, kind = "issue") {
+	return `https://github.com/${repo}/${kind === "pull" ? "pull" : "issues"}/${number}`;
+}
+function formatValue(value) {
+	if (value == null) return "";
+	if (value instanceof Date) return `${value.toLocaleString()} (${formatRelativeTime(value)})`;
+	if (typeof value === "number") return formatNumber(value);
+	return String(value);
+}
+function formatNumber(value) {
+	return value.toLocaleString();
+}
+function formatRelativeTime(date) {
+	const diff = (/* @__PURE__ */ new Date()).getTime() - date.getTime();
+	if (diff < 1e3) return "just now";
+	if (diff < 6e4) return `${Math.round(diff / 1e3)}s ago`;
+	if (diff < 36e5) return `${Math.round(diff / 6e4)}m ago`;
+	return date.toLocaleString();
+}
+function countNoun(count, singular, plural = `${singular}s`) {
+	return `${count} ${count === 1 ? singular : plural}`;
+}
+function formatDuration(durationMs) {
+	if (durationMs < 1e3) return `${durationMs}ms`;
+	return `${(durationMs / 1e3).toFixed(2)}s`;
+}
+//#endregion
+//#region src/utils/reactions.ts
+const REACTION_KEYS = [
+	"plusOne",
+	"minusOne",
+	"laugh",
+	"hooray",
+	"confused",
+	"heart",
+	"rocket",
+	"eyes"
+];
+/**
+* GitHub's wire format for reaction content (REST + GraphQL accept these
+* strings, sometimes uppercased in GraphQL). Order matches REACTION_KEYS.
+*/
+const REACTION_CONTENTS = [
+	"+1",
+	"-1",
+	"laugh",
+	"hooray",
+	"confused",
+	"heart",
+	"rocket",
+	"eyes"
+];
+const CONTENT_TO_KEY = {
+	"+1": "plusOne",
+	"-1": "minusOne",
+	"laugh": "laugh",
+	"hooray": "hooray",
+	"confused": "confused",
+	"heart": "heart",
+	"rocket": "rocket",
+	"eyes": "eyes"
+};
+function reactionKeyFromContent(content) {
+	return CONTENT_TO_KEY[content];
+}
+function isReactionContent(value) {
+	return typeof value === "string" && REACTION_CONTENTS.includes(value);
+}
+function createEmptyReactions() {
+	return {
+		totalCount: 0,
+		plusOne: 0,
+		minusOne: 0,
+		laugh: 0,
+		hooray: 0,
+		confused: 0,
+		heart: 0,
+		rocket: 0,
+		eyes: 0
+	};
+}
+function normalizeReactions(reactions) {
+	const normalized = createEmptyReactions();
+	if (!reactions) return normalized;
+	for (const key of REACTION_KEYS) normalized[key] = normalizeCount(reactions[key]);
+	const computedTotal = REACTION_KEYS.reduce((sum, key) => sum + normalized[key], 0);
+	normalized.totalCount = Math.max(normalizeCount(reactions.totalCount), computedTotal);
+	return normalized;
+}
+function normalizeCount(value) {
+	if (typeof value !== "number") return 0;
+	if (!Number.isFinite(value)) return 0;
+	if (value <= 0) return 0;
+	return Math.floor(value);
+}
+//#endregion
+//#region src/providers/helpers.ts
+async function collectPages(pages) {
+	const items = [];
+	for await (const page of pages) items.push(...page);
+	return items;
+}
+async function* iteratePages(pages) {
+	for await (const page of pages) for (const item of page) yield item;
+}
+//#endregion
+//#region src/providers/github/client.ts
+const BaseOctokit = Octokit.plugin(retry, throttling);
+function createGitHubClient(token) {
+	return new BaseOctokit({
+		auth: token,
+		throttle: {
+			onRateLimit: (retryAfter, options) => {
+				if ((options.request.retryCount ?? 0) < 2) return true;
+				return false;
+			},
+			onSecondaryRateLimit: () => {
+				return false;
+			}
+		},
+		retry: {
+			doNotRetry: [401, 403],
+			retries: 2
+		}
+	});
+}
+//#endregion
+//#region src/providers/github/provider.ts
+function createGitHubProvider(options) {
+	const octokit = createGitHubClient(options.token);
+	const { owner, repo } = options;
+	let requestCount = 0;
+	const bumpRequestCount = () => {
+		requestCount += 1;
+	};
+	let authenticatedUserPromise = null;
+	const fetchAuthenticatedUserCached = () => {
+		if (!authenticatedUserPromise) authenticatedUserPromise = fetchAuthenticatedUser(octokit, bumpRequestCount);
+		return authenticatedUserPromise;
+	};
+	return {
+		paginateItems: (paginateOptions) => paginateItems(octokit, owner, repo, paginateOptions, bumpRequestCount),
+		fetchItems: (paginateOptions) => fetchItems(octokit, owner, repo, paginateOptions, bumpRequestCount),
+		eachItem: (paginateOptions) => eachItem(octokit, owner, repo, paginateOptions, bumpRequestCount),
+		fetchItemsByNumbers: (numbers) => fetchItemsByNumbers(octokit, owner, repo, numbers, bumpRequestCount),
+		fetchComments: (number) => fetchComments(octokit, owner, repo, number, bumpRequestCount),
+		fetchPullMetadata: (number) => fetchPullMetadata(octokit, owner, repo, number, bumpRequestCount),
+		fetchPullPatch: (number) => fetchPullPatch(octokit, owner, repo, number, bumpRequestCount),
+		fetchPullCommits: (number) => fetchPullCommits(octokit, owner, repo, number, bumpRequestCount),
+		fetchTimeline: (number) => fetchTimeline(octokit, owner, repo, number, bumpRequestCount),
+		fetchItemSnapshot: (number) => fetchItemSnapshot(octokit, owner, repo, number, bumpRequestCount),
+		fetchRepository: () => fetchRepository(octokit, owner, repo, bumpRequestCount),
+		fetchRepositoryLabels: () => fetchRepositoryLabels(octokit, owner, repo, bumpRequestCount),
+		fetchRepositoryMilestones: () => fetchRepositoryMilestones(octokit, owner, repo, bumpRequestCount),
+		fetchAuthenticatedUser: fetchAuthenticatedUserCached,
+		countUpdatedSince: (since) => countUpdatedSince(octokit, owner, repo, since, bumpRequestCount),
+		getRequestCount: () => requestCount,
+		actionClose: (number) => actionClose(octokit, owner, repo, number, bumpRequestCount),
+		actionReopen: (number) => actionReopen(octokit, owner, repo, number, bumpRequestCount),
+		actionSetTitle: (number, title) => actionSetTitle(octokit, owner, repo, number, title, bumpRequestCount),
+		actionSetBody: (number, body) => actionSetBody(octokit, owner, repo, number, body, bumpRequestCount),
+		actionAddComment: (number, body) => actionAddComment(octokit, owner, repo, number, body, bumpRequestCount),
+		actionAddLabels: (number, labels) => actionAddLabels(octokit, owner, repo, number, labels, bumpRequestCount),
+		actionRemoveLabels: (number, labels) => actionRemoveLabels(octokit, owner, repo, number, labels, bumpRequestCount),
+		actionSetLabels: (number, labels) => actionSetLabels(octokit, owner, repo, number, labels, bumpRequestCount),
+		actionAddAssignees: (number, assignees) => actionAddAssignees(octokit, owner, repo, number, assignees, bumpRequestCount),
+		actionRemoveAssignees: (number, assignees) => actionRemoveAssignees(octokit, owner, repo, number, assignees, bumpRequestCount),
+		actionSetAssignees: (number, assignees) => actionSetAssignees(octokit, owner, repo, number, assignees, bumpRequestCount),
+		actionSetMilestone: (number, milestone) => actionSetMilestone(octokit, owner, repo, number, milestone, bumpRequestCount),
+		actionClearMilestone: (number) => actionClearMilestone(octokit, owner, repo, number, bumpRequestCount),
+		actionLock: (number, reason) => actionLock(octokit, owner, repo, number, reason, bumpRequestCount),
+		actionUnlock: (number) => actionUnlock(octokit, owner, repo, number, bumpRequestCount),
+		actionRequestReviewers: (number, reviewers) => actionRequestReviewers(octokit, owner, repo, number, reviewers, bumpRequestCount),
+		actionRemoveReviewers: (number, reviewers) => actionRemoveReviewers(octokit, owner, repo, number, reviewers, bumpRequestCount),
+		actionMarkReadyForReview: (number) => actionMarkReadyForReview(octokit, owner, repo, number, bumpRequestCount),
+		actionConvertToDraft: (number) => actionConvertToDraft(octokit, owner, repo, number, bumpRequestCount),
+		actionAddReaction: (number, reaction, target) => actionAddReaction(octokit, owner, repo, number, reaction, target, bumpRequestCount),
+		actionRemoveReaction: (number, reaction, target) => actionRemoveReaction(octokit, owner, repo, number, reaction, target, fetchAuthenticatedUserCached, bumpRequestCount),
+		fetchViewerReactions: (number, target) => fetchViewerReactions(octokit, owner, repo, number, target, fetchAuthenticatedUserCached, bumpRequestCount)
+	};
+}
+async function* paginateItems(octokit, owner, repo, options, bumpRequestCount) {
+	const iterator = octokit.paginate.iterator(octokit.rest.issues.listForRepo, {
+		owner,
+		repo,
+		state: options.state,
+		sort: "updated",
+		direction: "asc",
+		per_page: 100,
+		since: options.since
+	});
+	for await (const page of iterator) {
+		bumpRequestCount();
+		yield page.data.map(mapIssue);
+	}
+}
+async function fetchItems(octokit, owner, repo, options, bumpRequestCount) {
+	return await collectPages(paginateItems(octokit, owner, repo, options, bumpRequestCount));
+}
+async function* eachItem(octokit, owner, repo, options, bumpRequestCount) {
+	yield* iteratePages(paginateItems(octokit, owner, repo, options, bumpRequestCount));
+}
+async function fetchItemsByNumbers(octokit, owner, repo, numbers, bumpRequestCount) {
+	return (await Promise.all(numbers.map(async (number) => {
+		bumpRequestCount();
+		return mapIssue((await octokit.rest.issues.get({
+			owner,
+			repo,
+			issue_number: number
+		})).data);
+	}))).sort((a, b) => a.number - b.number);
+}
+async function fetchComments(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	return (await octokit.paginate(octokit.rest.issues.listComments, {
+		owner,
+		repo,
+		issue_number: number,
+		per_page: 100
+	})).map(mapComment);
+}
+async function fetchPullMetadata(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	const pull = (await octokit.rest.pulls.get({
+		owner,
+		repo,
+		pull_number: number
+	})).data;
+	return {
+		isDraft: pull.draft,
+		merged: pull.merged,
+		mergedAt: pull.merged_at,
+		baseRef: pull.base.ref,
+		headRef: pull.head.ref,
+		requestedReviewers: pull.requested_reviewers.map((reviewer) => reviewer.login)
+	};
+}
+async function fetchPullPatch(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	const result = await octokit.request("GET /repos/{owner}/{repo}/pulls/{pull_number}", {
+		owner,
+		repo,
+		pull_number: number,
+		mediaType: { format: "patch" }
+	});
+	if (typeof result.data === "string") return result.data;
+	throw diagnostics.GHFS0300({ issue: formatIssueNumber(number, {
+		repo: `${owner}/${repo}`,
+		kind: "pull"
+	}) });
+}
+async function fetchPullCommits(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	return (await octokit.paginate(octokit.rest.pulls.listCommits, {
+		owner,
+		repo,
+		pull_number: number,
+		per_page: 100
+	})).map(mapPullCommit);
+}
+async function fetchTimeline(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	const events = await octokit.paginate(octokit.rest.issues.listEventsForTimeline, {
+		owner,
+		repo,
+		issue_number: number,
+		per_page: 100
+	});
+	const out = [];
+	for (const event of events) {
+		const mapped = mapTimelineEvent(event);
+		if (mapped) out.push(mapped);
+	}
+	await enrichReviewReactions(octokit, out, bumpRequestCount);
+	return out;
+}
+async function enrichReviewReactions(octokit, events, bumpRequestCount) {
+	const reviewIds = events.flatMap((e) => e.kind === "reviewed" && e.review?.nodeId ? [e.review.nodeId] : []);
+	if (reviewIds.length === 0) return;
+	const unique = [...new Set(reviewIds)];
+	try {
+		bumpRequestCount();
+		const data = await octokit.graphql(`query ReviewReactions($ids: [ID!]!) {
+        nodes(ids: $ids) {
+          ... on PullRequestReview {
+            id
+            reactionGroups { content users(first: 0) { totalCount } }
+          }
+        }
+      }`, { ids: unique });
+		const byId = /* @__PURE__ */ new Map();
+		for (const node of data.nodes ?? []) {
+			if (!node?.id || !node.reactionGroups) continue;
+			const reactions = createEmptyReactions();
+			for (const group of node.reactionGroups) {
+				const wireContent = graphqlContentToReaction(group.content);
+				if (!wireContent) continue;
+				const count = group.users.totalCount;
+				if (count <= 0) continue;
+				reactions[reactionKeyFromContent(wireContent)] = count;
+				reactions.totalCount += count;
+			}
+			byId.set(node.id, reactions);
+		}
+		for (const event of events) {
+			if (event.kind !== "reviewed" || !event.review?.nodeId) continue;
+			const reactions = byId.get(event.review.nodeId);
+			if (reactions) event.review.reactions = reactions;
+		}
+	} catch {}
+}
+async function fetchItemSnapshot(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	const issue = (await octokit.rest.issues.get({
+		owner,
+		repo,
+		issue_number: number
+	})).data;
+	return {
+		number,
+		kind: issue.pull_request ? "pull" : "issue",
+		updatedAt: issue.updated_at ?? null
+	};
+}
+async function fetchRepository(octokit, owner, repo, bumpRequestCount) {
+	bumpRequestCount();
+	return (await octokit.rest.repos.get({
+		owner,
+		repo
+	})).data;
+}
+async function fetchRepositoryLabels(octokit, owner, repo, bumpRequestCount) {
+	bumpRequestCount();
+	return await octokit.paginate(octokit.rest.issues.listLabelsForRepo, {
+		owner,
+		repo,
+		per_page: 100
+	});
+}
+async function fetchRepositoryMilestones(octokit, owner, repo, bumpRequestCount) {
+	bumpRequestCount();
+	return await octokit.paginate(octokit.rest.issues.listMilestones, {
+		owner,
+		repo,
+		state: "all",
+		per_page: 100
+	});
+}
+async function fetchAuthenticatedUser(octokit, bumpRequestCount) {
+	bumpRequestCount();
+	try {
+		const result = await octokit.rest.users.getAuthenticated();
+		return {
+			login: result.data.login,
+			name: result.data.name ?? null,
+			avatarUrl: result.data.avatar_url
+		};
+	} catch {
+		return null;
+	}
+}
+async function countUpdatedSince(octokit, owner, repo, since, bumpRequestCount) {
+	bumpRequestCount();
+	const sinceQuery = normalizeSinceForSearch(since);
+	const result = await octokit.graphql(`query CountsUpdated($issuesQuery: String!, $pullsQuery: String!) {
+      issues: search(query: $issuesQuery, type: ISSUE, first: 0) { issueCount }
+      pulls: search(query: $pullsQuery, type: ISSUE, first: 0) { issueCount }
+    }`, {
+		issuesQuery: `repo:${owner}/${repo} is:issue updated:>=${sinceQuery}`,
+		pullsQuery: `repo:${owner}/${repo} is:pr updated:>=${sinceQuery}`
+	});
+	return {
+		issues: result.issues.issueCount,
+		pulls: result.pulls.issueCount
+	};
+}
+function normalizeSinceForSearch(since) {
+	const date = new Date(since);
+	if (Number.isNaN(date.getTime())) return since;
+	return date.toISOString();
+}
+async function actionClose(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		state: "closed"
+	});
+}
+async function actionReopen(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		state: "open"
+	});
+}
+async function actionSetTitle(octokit, owner, repo, number, title, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		title
+	});
+}
+async function actionSetBody(octokit, owner, repo, number, body, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		body
+	});
+}
+async function actionAddComment(octokit, owner, repo, number, body, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.createComment({
+		owner,
+		repo,
+		issue_number: number,
+		body
+	});
+}
+async function actionAddLabels(octokit, owner, repo, number, labels, bumpRequestCount) {
+	await ensureLabelsExist(octokit, owner, repo, labels, bumpRequestCount);
+	bumpRequestCount();
+	await octokit.rest.issues.addLabels({
+		owner,
+		repo,
+		issue_number: number,
+		labels
+	});
+}
+async function actionRemoveLabels(octokit, owner, repo, number, labels, bumpRequestCount) {
+	for (const label of labels) try {
+		bumpRequestCount();
+		await octokit.rest.issues.removeLabel({
+			owner,
+			repo,
+			issue_number: number,
+			name: label
+		});
+	} catch (error) {
+		if (error.status !== 404) throw error;
+	}
+}
+async function actionSetLabels(octokit, owner, repo, number, labels, bumpRequestCount) {
+	await ensureLabelsExist(octokit, owner, repo, labels, bumpRequestCount);
+	bumpRequestCount();
+	await octokit.rest.issues.setLabels({
+		owner,
+		repo,
+		issue_number: number,
+		labels
+	});
+}
+async function ensureLabelsExist(octokit, owner, repo, labels, bumpRequestCount) {
+	if (!labels.length) return;
+	const existingLabels = await fetchRepositoryLabels(octokit, owner, repo, bumpRequestCount);
+	const existingLabelNames = new Set(existingLabels.map((label) => label.name.toLowerCase()));
+	for (const label of labels) {
+		const normalizedLabel = label.toLowerCase();
+		if (existingLabelNames.has(normalizedLabel)) continue;
+		try {
+			bumpRequestCount();
+			await octokit.rest.issues.createLabel({
+				owner,
+				repo,
+				name: label,
+				color: randomHexColor()
+			});
+			existingLabelNames.add(normalizedLabel);
+		} catch (error) {
+			if (error.status !== 422) throw error;
+			existingLabelNames.add(normalizedLabel);
+		}
+	}
+}
+async function actionAddAssignees(octokit, owner, repo, number, assignees, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.addAssignees({
+		owner,
+		repo,
+		issue_number: number,
+		assignees
+	});
+}
+async function actionRemoveAssignees(octokit, owner, repo, number, assignees, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.removeAssignees({
+		owner,
+		repo,
+		issue_number: number,
+		assignees
+	});
+}
+async function actionSetAssignees(octokit, owner, repo, number, assignees, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		assignees
+	});
+}
+async function actionSetMilestone(octokit, owner, repo, number, milestone, bumpRequestCount) {
+	const resolvedMilestone = await resolveMilestone(octokit, owner, repo, milestone, bumpRequestCount);
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		milestone: resolvedMilestone
+	});
+}
+async function actionClearMilestone(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.update({
+		owner,
+		repo,
+		issue_number: number,
+		milestone: null
+	});
+}
+async function actionLock(octokit, owner, repo, number, reason, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.lock({
+		owner,
+		repo,
+		issue_number: number,
+		lock_reason: normalizeLockReason(reason)
+	});
+}
+async function actionUnlock(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.issues.unlock({
+		owner,
+		repo,
+		issue_number: number
+	});
+}
+async function actionRequestReviewers(octokit, owner, repo, number, reviewers, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.pulls.requestReviewers({
+		owner,
+		repo,
+		pull_number: number,
+		reviewers
+	});
+}
+async function actionRemoveReviewers(octokit, owner, repo, number, reviewers, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.rest.pulls.removeRequestedReviewers({
+		owner,
+		repo,
+		pull_number: number,
+		reviewers
+	});
+}
+async function actionMarkReadyForReview(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.request("POST /repos/{owner}/{repo}/pulls/{pull_number}/ready_for_review", {
+		owner,
+		repo,
+		pull_number: number
+	});
+}
+async function actionConvertToDraft(octokit, owner, repo, number, bumpRequestCount) {
+	bumpRequestCount();
+	await octokit.request("POST /repos/{owner}/{repo}/pulls/{pull_number}/convert-to-draft", {
+		owner,
+		repo,
+		pull_number: number
+	});
+}
+async function resolveMilestone(octokit, owner, repo, value, bumpRequestCount) {
+	if (typeof value === "number") return value;
+	if (/^\d+$/.test(value)) return Number(value);
+	bumpRequestCount();
+	const matched = (await octokit.paginate(octokit.rest.issues.listMilestones, {
+		owner,
+		repo,
+		state: "all",
+		per_page: 100
+	})).find((item) => item.title === value);
+	if (!matched) throw diagnostics.GHFS0301({ value });
+	return matched.number;
+}
+function normalizeLockReason(reason) {
+	if (!reason) return void 0;
+	if (reason === "too-heated") return "too heated";
+	return reason;
+}
+function mapIssue(issue) {
+	return {
+		number: issue.number,
+		kind: issue.pull_request ? "pull" : "issue",
+		...issue.html_url ? { url: issue.html_url } : {},
+		state: issue.state === "closed" ? "closed" : "open",
+		stateReason: normalizeStateReason(issue.state_reason),
+		updatedAt: issue.updated_at,
+		createdAt: issue.created_at,
+		closedAt: issue.closed_at,
+		title: issue.title,
+		body: issue.body,
+		author: issue.user?.login ?? null,
+		...issue.user?.avatar_url ? { authorAvatarUrl: issue.user.avatar_url } : {},
+		labels: issue.labels.map((label) => {
+			if (typeof label === "string") return label;
+			return label.name ?? void 0;
+		}).filter((label) => Boolean(label)),
+		assignees: (issue.assignees ?? []).map((assignee) => assignee.login),
+		milestone: issue.milestone?.title ?? null,
+		reactions: mapReactions(issue.reactions)
+	};
+}
+function normalizeStateReason(reason) {
+	if (reason === "completed" || reason === "not_planned" || reason === "reopened") return reason;
+	return null;
+}
+function mapComment(comment) {
+	return {
+		id: comment.id,
+		body: comment.body,
+		createdAt: comment.created_at,
+		updatedAt: comment.updated_at,
+		author: comment.user?.login ?? null,
+		...comment.user?.avatar_url ? { authorAvatarUrl: comment.user.avatar_url } : {},
+		reactions: mapReactions(comment.reactions)
+	};
+}
+function mapPullCommit(commit) {
+	return {
+		sha: commit.sha,
+		message: commit.commit.message,
+		authorLogin: commit.author?.login ?? null,
+		authorName: commit.commit.author?.name ?? null,
+		authorDate: commit.commit.author?.date ?? commit.commit.committer?.date ?? "",
+		committerLogin: commit.committer?.login ?? null,
+		committerDate: commit.commit.committer?.date ?? commit.commit.author?.date ?? "",
+		...commit.html_url ? { url: commit.html_url } : {}
+	};
+}
+function mapTimelineEvent(event) {
+	const eventName = event.event;
+	if (!eventName) return null;
+	if (eventName === "committed" && event.sha) {
+		const createdAt = event.committer?.date ?? event.author?.date;
+		if (!createdAt) return null;
+		const fullMessage = event.message ?? "";
+		const firstLine = fullMessage.split("\n", 1)[0] ?? "";
+		return {
+			id: `commit:${event.sha}`,
+			kind: "committed",
+			createdAt,
+			actor: event.author?.name ?? event.committer?.name ?? null,
+			sha: event.sha,
+			commitMessage: firstLine,
+			body: fullMessage,
+			...event.commit_url ? { commitUrl: event.commit_url } : {}
+		};
+	}
+	const createdAt = event.created_at ?? event.submitted_at;
+	if (!createdAt) return null;
+	const id = event.id != null ? String(event.id) : `${eventName}:${createdAt}`;
+	const actor = event.actor?.login ?? event.user?.login ?? null;
+	const actorAvatarUrl = event.actor?.avatar_url ?? event.user?.avatar_url ?? void 0;
+	const base = {
+		id,
+		createdAt,
+		actor,
+		...actorAvatarUrl ? { actorAvatarUrl } : {}
+	};
+	function extractSource() {
+		const issue = event.source?.issue;
+		if (!issue?.number) return void 0;
+		return {
+			number: issue.number,
+			kind: issue.pull_request ? "pull" : "issue",
+			...issue.title ? { title: issue.title } : {},
+			...issue.html_url ? { url: issue.html_url } : {},
+			...issue.repository?.full_name ? { repo: issue.repository.full_name } : {}
+		};
+	}
+	switch (eventName) {
+		case "closed": return {
+			...base,
+			kind: "closed",
+			...event.state_reason ? { stateReason: event.state_reason } : {},
+			...event.commit_id ? { sha: event.commit_id } : {},
+			...event.commit_url ? { commitUrl: event.commit_url } : {}
+		};
+		case "reopened": return {
+			...base,
+			kind: "reopened"
+		};
+		case "merged": return {
+			...base,
+			kind: "merged",
+			...event.commit_id ? { sha: event.commit_id } : {},
+			...event.commit_url ? { commitUrl: event.commit_url } : {}
+		};
+		case "head_ref_force_pushed": return {
+			...base,
+			kind: "head_ref_force_pushed",
+			...event.commit_id ? { sha: event.commit_id } : {},
+			...event.commit_url ? { commitUrl: event.commit_url } : {}
+		};
+		case "head_ref_deleted":
+		case "head_ref_restored":
+		case "unlocked":
+		case "ready_for_review":
+		case "convert_to_draft":
+		case "pinned":
+		case "unpinned":
+		case "mentioned":
+		case "subscribed":
+		case "unsubscribed": return {
+			...base,
+			kind: eventName
+		};
+		case "locked": return {
+			...base,
+			kind: "locked",
+			...event.lock_reason ? { lockReason: event.lock_reason } : {}
+		};
+		case "labeled":
+		case "unlabeled":
+			if (!event.label) return null;
+			return {
+				...base,
+				kind: eventName,
+				label: {
+					name: event.label.name,
+					color: event.label.color ?? ""
+				}
+			};
+		case "assigned":
+		case "unassigned":
+			if (!event.assignee?.login) return null;
+			return {
+				...base,
+				kind: eventName,
+				assignee: event.assignee.login
+			};
+		case "review_requested":
+		case "review_request_removed": {
+			const userLogin = event.requested_reviewer?.login;
+			const teamName = event.requested_team?.name;
+			const reviewer = userLogin ?? teamName;
+			if (!reviewer) return null;
+			return {
+				...base,
+				kind: eventName,
+				requestedReviewer: reviewer,
+				...userLogin ? {} : { isTeam: true }
+			};
+		}
+		case "reviewed": {
+			const rawState = event.state ?? "commented";
+			return {
+				...base,
+				kind: "reviewed",
+				review: {
+					state: normalizeReviewState(rawState),
+					body: event.body ?? null,
+					submittedAt: event.submitted_at ?? createdAt,
+					...event.node_id ? { nodeId: event.node_id } : {}
+				},
+				body: event.body ?? null
+			};
+		}
+		case "review_dismissed": {
+			const dismissed = event.dismissed_review;
+			if (!dismissed) return {
+				...base,
+				kind: "unknown",
+				rawKind: eventName
+			};
+			return {
+				...base,
+				kind: "review_dismissed",
+				dismissedReview: {
+					state: dismissed.state,
+					reviewId: dismissed.review_id,
+					dismissalMessage: dismissed.dismissal_message
+				},
+				...event.review?.user?.login ? { reviewedBy: event.review.user.login } : {}
+			};
+		}
+		case "commented": return {
+			...base,
+			kind: "commented",
+			...typeof event.id === "number" ? { commentId: event.id } : {},
+			body: event.body ?? null
+		};
+		case "renamed":
+			if (!event.rename) return null;
+			return {
+				...base,
+				kind: "renamed",
+				rename: {
+					from: event.rename.from,
+					to: event.rename.to
+				}
+			};
+		case "referenced":
+		case "cross-referenced":
+		case "connected":
+		case "disconnected":
+		case "marked_as_duplicate":
+		case "unmarked_as_duplicate": {
+			const source = extractSource();
+			return {
+				...base,
+				kind: eventName,
+				...source ? { source } : {}
+			};
+		}
+		case "milestoned":
+		case "demilestoned": return {
+			...base,
+			kind: eventName,
+			...event.milestone?.title ? { milestone: event.milestone.title } : {}
+		};
+		case "transferred": {
+			const fromRepo = event.transferred?.from_repository?.full_name ?? event.from_repository?.full_name;
+			return {
+				...base,
+				kind: "transferred",
+				...fromRepo ? { fromRepo } : {}
+			};
+		}
+		case "base_ref_changed": {
+			const fromRef = event.changes?.base?.ref?.from ?? event.base_ref?.from;
+			const toRef = event.changes?.base?.ref?.to ?? event.base_ref?.to;
+			return {
+				...base,
+				kind: "base_ref_changed",
+				...fromRef ? { oldRef: fromRef } : {},
+				...toRef ? { newRef: toRef } : {}
+			};
+		}
+		case "auto_merge_enabled":
+		case "auto_merge_disabled":
+		case "auto_squash_enabled":
+		case "auto_squash_disabled":
+		case "auto_rebase_enabled":
+		case "auto_rebase_disabled": return {
+			...base,
+			kind: eventName,
+			...event.commit_title ? { commitTitle: event.commit_title } : {},
+			...event.commit_message ? { commitMessage: event.commit_message } : {}
+		};
+		default: return {
+			...base,
+			kind: "unknown",
+			rawKind: eventName
+		};
+	}
+}
+function normalizeReviewState(state) {
+	const lower = state.toLowerCase();
+	if (lower === "approved" || lower === "changes_requested" || lower === "commented" || lower === "dismissed" || lower === "pending") return lower;
+	return "commented";
+}
+const REACTION_TO_GRAPHQL = {
+	"+1": "THUMBS_UP",
+	"-1": "THUMBS_DOWN",
+	"laugh": "LAUGH",
+	"hooray": "HOORAY",
+	"confused": "CONFUSED",
+	"heart": "HEART",
+	"rocket": "ROCKET",
+	"eyes": "EYES"
+};
+const GRAPHQL_TO_REACTION = Object.fromEntries(Object.entries(REACTION_TO_GRAPHQL).map(([k, v]) => [v, k]));
+function graphqlContentToReaction(graphqlContent) {
+	return GRAPHQL_TO_REACTION[graphqlContent] ?? null;
+}
+async function actionAddReaction(octokit, owner, repo, number, reaction, target, bumpRequestCount) {
+	bumpRequestCount();
+	if (target.kind === "item") {
+		await octokit.rest.reactions.createForIssue({
+			owner,
+			repo,
+			issue_number: number,
+			content: reaction
+		});
+		return;
+	}
+	if (target.kind === "comment") {
+		await octokit.rest.reactions.createForIssueComment({
+			owner,
+			repo,
+			comment_id: target.commentId,
+			content: reaction
+		});
+		return;
+	}
+	await octokit.graphql(`mutation AddReviewReaction($subjectId: ID!, $content: ReactionContent!) {
+      addReaction(input: { subjectId: $subjectId, content: $content }) {
+        reaction { id }
+      }
+    }`, {
+		subjectId: target.reviewId,
+		content: REACTION_TO_GRAPHQL[reaction]
+	});
+}
+async function actionRemoveReaction(octokit, owner, repo, number, reaction, target, fetchAuth, bumpRequestCount) {
+	if (target.kind === "review") {
+		bumpRequestCount();
+		await octokit.graphql(`mutation RemoveReviewReaction($subjectId: ID!, $content: ReactionContent!) {
+        removeReaction(input: { subjectId: $subjectId, content: $content }) {
+          reaction { id }
+        }
+      }`, {
+			subjectId: target.reviewId,
+			content: REACTION_TO_GRAPHQL[reaction]
+		});
+		return;
+	}
+	const user = await fetchAuth();
+	if (!user) throw diagnostics.GHFS0302();
+	if (target.kind === "item") {
+		bumpRequestCount();
+		const mine = (await octokit.paginate(octokit.rest.reactions.listForIssue, {
+			owner,
+			repo,
+			issue_number: number,
+			content: reaction,
+			per_page: 100
+		})).find((r) => r.user?.login === user.login && r.content === reaction);
+		if (!mine) return;
+		bumpRequestCount();
+		await octokit.rest.reactions.deleteForIssue({
+			owner,
+			repo,
+			issue_number: number,
+			reaction_id: mine.id
+		});
+		return;
+	}
+	bumpRequestCount();
+	const mineComment = (await octokit.paginate(octokit.rest.reactions.listForIssueComment, {
+		owner,
+		repo,
+		comment_id: target.commentId,
+		content: reaction,
+		per_page: 100
+	})).find((r) => r.user?.login === user.login && r.content === reaction);
+	if (!mineComment) return;
+	bumpRequestCount();
+	await octokit.rest.reactions.deleteForIssueComment({
+		owner,
+		repo,
+		comment_id: target.commentId,
+		reaction_id: mineComment.id
+	});
+}
+async function fetchViewerReactions(octokit, owner, repo, number, target, fetchAuth, bumpRequestCount) {
+	if (target.kind === "review") {
+		bumpRequestCount();
+		return ((await octokit.graphql(`query ViewerReviewReactions($id: ID!) {
+        node(id: $id) {
+          ... on PullRequestReview {
+            reactionGroups { content viewerHasReacted }
+          }
+        }
+      }`, { id: target.reviewId })).node?.reactionGroups ?? []).filter((g) => g.viewerHasReacted).map((g) => graphqlContentToReaction(g.content)).filter((c) => c !== null);
+	}
+	const user = await fetchAuth();
+	if (!user) return [];
+	if (target.kind === "item") {
+		bumpRequestCount();
+		return collectViewerReactions(await octokit.paginate(octokit.rest.reactions.listForIssue, {
+			owner,
+			repo,
+			issue_number: number,
+			per_page: 100
+		}), user.login);
+	}
+	bumpRequestCount();
+	return collectViewerReactions(await octokit.paginate(octokit.rest.reactions.listForIssueComment, {
+		owner,
+		repo,
+		comment_id: target.commentId,
+		per_page: 100
+	}), user.login);
+}
+function collectViewerReactions(reactions, login) {
+	const out = /* @__PURE__ */ new Set();
+	for (const r of reactions) {
+		if (r.user?.login !== login) continue;
+		if (isReactionContent(r.content)) out.add(r.content);
+	}
+	return [...out];
+}
+function mapReactions(reactions) {
+	return normalizeReactions({
+		totalCount: reactions?.total_count,
+		plusOne: reactions?.["+1"],
+		minusOne: reactions?.["-1"],
+		laugh: reactions?.laugh,
+		hooray: reactions?.hooray,
+		confused: reactions?.confused,
+		heart: reactions?.heart,
+		rocket: reactions?.rocket,
+		eyes: reactions?.eyes
+	});
+}
+//#endregion
+//#region src/providers/factory.ts
+function createRepositoryProvider(options) {
+	const { owner, repo } = splitRepo(options.repo);
+	return createGitHubProvider({
+		token: options.token,
+		owner,
+		repo
+	});
+}
+//#endregion
+export { countNoun as a, formatTerminalLink as c, diagnostics as d, normalizeReactions as i, formatValue as l, REACTION_CONTENTS as n, formatDuration as o, isReactionContent as r, formatIssueNumber as s, createRepositoryProvider as t, formatInline as u };