@theholocron/holocron-plugin-github 5.0.0-alpha.376 → 5.0.0-alpha.378

package/dist/index.mjs

@@ -152,6 +152,18 @@ var GitHubEnvironments = class {
 	}
 };
 // src/capabilities/issues-migration.ts
+/**
+* Export and import of GitHub issues for `holocron migrate`.
+*
+* GitHub holds less than a planning tool, so what does not fit is named in each result's `dropped` list rather than
+* lost quietly:
+*  - priority is a label (`priority: high`), because on GitHub it lives in a project field, not on the issue;
+*  - an import cannot backdate an issue or a comment, and cannot post as someone else, so the original date and
+*    author go in the text;
+*  - an import does not set parent or blocked-by links (they need GraphQL node ids of issues made in the same run);
+*  - an assignee is not mapped (a Linear user is not a GitHub login).
+* A migrated issue ends with `<!-- holocron:migrated-from <url> -->`, which is how a second run finds it.
+*/
 const MARKER = /<!-- holocron:migrated-from (\S+) -->/;
 const PRIORITY_LABEL = /^priority\s*[:/-]\s*(urgent|high|medium|low)$/i;
 const LINK_QUERY = `query($owner: String!, $name: String!, $number: Int!) { repository(owner: $owner, name: $name) {
@@ -177,11 +189,36 @@ function categoryOf(issue) {
 	if (names.some((n) => n === "status:in-progress" || n === "status: in progress")) return "in-progress";
 	return "open";
 }
+/** How many issues an export fetches at once. GitHub's secondary rate limit punishes bursts of requests, not volume. */
+const EXPORT_CONCURRENCY = 4;
+/** Runs `fn` over `items`, at most `limit` at a time, and returns the results in the order of `items`. */
+async function mapLimit(items, limit, fn) {
+	const results = new Array(items.length);
+	let next = 0;
+	const worker = async () => {
+		while (next < items.length) {
+			const at = next++;
+			results[at] = await fn(items[at]);
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+	return results;
+}
+/** GitHub's own answer to a burst of requests (403 or 429 naming the secondary limit) becomes a message that says what to do. */
+function explainSecondaryLimit(err) {
+	if (err instanceof ProviderApiError && (err.status === 403 || err.status === 429) && String(err.details).includes("secondary rate limit")) return /* @__PURE__ */ new Error("GitHub's secondary rate limit stopped the export. It limits bursts of requests, not the hourly quota, and nothing has been written. Wait a couple of minutes and run the command again.");
+	return err;
+}
 /** Reads the issues `selector` names, with their comments, priority label, parent and blockers. */
 async function exportIssues(client, repo, selector) {
+	return readIssues(client, repo, selector).catch((err) => {
+		throw explainSecondaryLimit(err);
+	});
+}
+async function readIssues(client, repo, selector) {
 	const [owner = "", name = ""] = repo.split("/", 2);
 	let raw;
-	if (selector.keys) raw = await Promise.all(selector.keys.map((k) => client.issues.getIssue(repo, parseNumber(k))));
+	if (selector.keys) raw = await mapLimit(selector.keys, EXPORT_CONCURRENCY, (k) => client.issues.getIssue(repo, parseNumber(k)));
 	else if (selector.milestone) {
 		const milestone = await findMilestone(client, repo, selector.milestone);
 		if (!milestone) throw new Error(`Milestone "${selector.milestone}" not found in ${repo}.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-github",
-  "version": "5.0.0-alpha.376",
+  "version": "5.0.0-alpha.378",
   "description": "Holocron plugin for GitHub. Implements source, ci, secrets, environments, and issues capabilities against the GitHub REST API.",
   "keywords": [
     "ci",
@@ -44,21 +44,21 @@
     "tsx": "4.23.15",
     "typescript": "^5.9.3",
     "vitest": "^5.1.0",
-    "@theholocron/cli": "5.0.0-alpha.376",
-    "@theholocron/eslint-config": "^8.9.0-alpha.12",
     "@theholocron/fs-utils": "^1.17.0-alpha.2",
+    "@theholocron/eslint-config": "^8.9.0-alpha.12",
     "@theholocron/github-client": "^1.58.0-alpha.22",
-    "@theholocron/misc-utils": "^1.17.0-alpha.2",
     "@theholocron/http-client": "^1.58.0-alpha.22",
+    "@theholocron/misc-utils": "^1.17.0-alpha.2",
     "@theholocron/tsdown-config": "^8.9.0-alpha.12",
     "@theholocron/vitest-config": "^8.9.0-alpha.12",
-    "@theholocron/tsconfig": "^8.9.0-alpha.12"
+    "@theholocron/tsconfig": "^8.9.0-alpha.12",
+    "@theholocron/cli": "5.0.0-alpha.378"
   },
   "peerDependencies": {
     "@theholocron/fs-utils": "^1.16.0",
     "@theholocron/github-client": "^1.58.0",
     "@theholocron/misc-utils": "^1.16.0",
-    "@theholocron/cli": "5.0.0-alpha.376"
+    "@theholocron/cli": "5.0.0-alpha.378"
   },
   "engines": {
     "node": ">=22"