@theholocron/holocron-plugin-github 5.0.0-alpha.369 → 5.0.0-alpha.370

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Auth, AuthError, BoardItem, BoardState, BoardSummary, BoardTemplate, Ci, CiRun, CiRunFilter, EnsureReport, Environment, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, MoveReport, PagesConfig, PluginToken, Projects, PullRequest, RepoRef, RepoSettings, ResolveTokenInput, Ruleset, SecretScope, Secrets, Source, SourceBranch, SourceFile, SourceRepoInfo, SourceRulesetDetail, SourceSecurity, SourceTeamMember, TeamEntry, TeamEntry as TeamEntry$1, TeamPermission, TeamPermission as TeamPermission$1, TrackerDoctorReport, TrackerUser, VerifyTokenFailure, VerifyTokenResult, VerifyTokenResult as VerifyTokenResult$1, VerifyTokenSuccess, createFeatureResolver } from "@theholocron/cli";
+import { Auth, AuthError, BoardItem, BoardState, BoardSummary, BoardTemplate, Ci, CiRun, CiRunFilter, EnsureReport, Environment, Environments, ImportOptions, ImportResult, Issue, IssueRecord, IssueSearchFilter, IssueSelector, Issues, LabelDef, LifecycleResult, LifecycleSlot, MoveReport, PagesConfig, PluginToken, Projects, PullRequest, RepoRef, RepoSettings, ResolveTokenInput, Ruleset, SecretScope, Secrets, Source, SourceBranch, SourceFile, SourceRepoInfo, SourceRulesetDetail, SourceSecurity, SourceTeamMember, TeamEntry, TeamEntry as TeamEntry$1, TeamPermission, TeamPermission as TeamPermission$1, TrackerDoctorReport, TrackerUser, VerifyTokenFailure, VerifyTokenResult, VerifyTokenResult as VerifyTokenResult$1, VerifyTokenSuccess, createFeatureResolver } from "@theholocron/cli";
 import { GitHubClient, GitHubClientOptions, GraphQLClient, createGitHubClient } from "@theholocron/github-client";
 /** Resolves the token for read-only GitHub access (`HOLOCRON_READ_TOKEN`, keyring key `github.read`). */
 export declare const resolveReadToken: import("@theholocron/cli").FeatureResolver;
@@ -104,6 +104,10 @@ export declare class GitHubIssues implements Issues {
   comment(key: string, body: string): Promise<void>;
   /** Checks the authenticated user, the repo and the label-backed lifecycle slots, and reports what resolves. */
   doctor(): Promise<TrackerDoctorReport>;
+  /** Reads issues with their comments, priority label, parent and blockers, for `holocron migrate`. */
+  export(selector: IssueSelector): Promise<IssueRecord[]>;
+  /** Makes the records as issues; one already made by an earlier run is skipped. */
+  import(records: IssueRecord[], options?: ImportOptions): Promise<ImportResult[]>;
   private resolveMilestone;
   private removeStatusLabels;
   private mapIssue;

package/dist/index.mjs

@@ -151,6 +151,166 @@ var GitHubEnvironments = class {
 		}));
 	}
 };
+// src/capabilities/issues-migration.ts
+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) {
+	issue(number: $number) { parent { number } blockedBy(first: 50) { nodes { number } } } } }`;
+/** Splits `priority: high` labels from the rest. */
+function splitLabels(names) {
+	let priority;
+	const labels = [];
+	for (const name of names) {
+		const match = PRIORITY_LABEL.exec(name);
+		if (match) priority = match[1].toLowerCase();
+		else labels.push(name);
+	}
+	return {
+		labels,
+		...priority ? { priority } : {}
+	};
+}
+function categoryOf(issue) {
+	if (issue.state === "closed") return "done";
+	const names = issue.labels.map((l) => l.name.toLowerCase());
+	if (names.some((n) => n === "status:in-review" || n === "status: in review")) return "in-review";
+	if (names.some((n) => n === "status:in-progress" || n === "status: in progress")) return "in-progress";
+	return "open";
+}
+/** Reads the issues `selector` names, with their comments, priority label, parent and blockers. */
+async function exportIssues(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))));
+	else if (selector.milestone) {
+		const milestone = await findMilestone(client, repo, selector.milestone);
+		if (!milestone) throw new Error(`Milestone "${selector.milestone}" not found in ${repo}.`);
+		raw = await listAll(client, repo, { milestone: String(milestone.number) });
+	} else if (selector.all) raw = await listAll(client, repo, {});
+	else throw new Error("export needs keys, a milestone or all");
+	const issues = raw.filter((i) => !i.pull_request && !(selector.openOnly && i.state === "closed"));
+	const records = [];
+	for (const issue of issues) {
+		const comments = await client.issues.listComments(repo, issue.number);
+		const links = (await client.graphql.query(LINK_QUERY, {
+			owner,
+			name,
+			number: issue.number
+		}).catch(() => void 0))?.repository.issue;
+		const { labels, priority } = splitLabels(issue.labels.map((l) => l.name));
+		const body = issue.body?.replace(MARKER, "").trimEnd();
+		records.push({
+			key: `#${issue.number}`,
+			url: issue.html_url,
+			title: issue.title,
+			...body ? { body } : {},
+			statusCategory: categoryOf(issue),
+			closed: issue.state === "closed",
+			...priority ? { priority } : {},
+			labels: labels.filter((l) => !l.toLowerCase().startsWith("status:")),
+			...issue.assignee ? { assignee: {
+				id: issue.assignee.login,
+				displayName: issue.assignee.name ?? issue.assignee.login,
+				...issue.assignee.email ? { emailAddress: issue.assignee.email } : {}
+			} } : {},
+			...issue.milestone ? { milestone: issue.milestone.title } : {},
+			...links?.parent ? { parent: `#${links.parent.number}` } : {},
+			blockedBy: (links?.blockedBy.nodes ?? []).map((n) => `#${n.number}`),
+			comments: comments.map((c) => ({
+				...c.user ? { author: c.user.login } : {},
+				body: c.body,
+				createdAt: c.created_at
+			})),
+			createdAt: issue.created_at ?? issue.updated_at,
+			updatedAt: issue.updated_at
+		});
+	}
+	return records;
+}
+/** Makes the records as issues, skipping any whose source address an earlier run already recorded. */
+async function importIssues(client, repo, records, options = {}) {
+	const existing = /* @__PURE__ */ new Map();
+	for (const issue of await listAll(client, repo, {})) {
+		const url = issue.body ? MARKER.exec(issue.body)?.[1] : void 0;
+		if (url) existing.set(url, issue.number);
+	}
+	const results = [];
+	for (const record of records) {
+		const found = existing.get(record.url);
+		if (found !== void 0) {
+			results.push({
+				source: record.key,
+				key: `#${found}`,
+				created: false,
+				dropped: []
+			});
+			continue;
+		}
+		const dropped = ["createdAt (GitHub sets it; the original date is in the text)"];
+		if (record.assignee) dropped.push("assignee (not mapped)");
+		if (record.parent) dropped.push("parent (not set on GitHub)");
+		if (record.blockedBy.length > 0) dropped.push("blockedBy (not set on GitHub)");
+		if (options.dryRun) {
+			results.push({
+				source: record.key,
+				created: true,
+				dropped
+			});
+			continue;
+		}
+		const milestoneName = options.milestone ?? record.milestone;
+		const milestone = milestoneName ? await ensureMilestone(client, repo, milestoneName) : void 0;
+		const labels = [...record.labels, ...record.priority && record.priority !== "none" ? [`priority: ${record.priority}`] : []];
+		const created = await client.issues.createIssue(repo, {
+			title: record.title,
+			body: withProvenance(record),
+			...labels.length > 0 ? { labels } : {},
+			...milestone !== void 0 ? { milestone } : {}
+		});
+		for (const comment of record.comments) {
+			const who = comment.author ? `**${comment.author}**` : "Someone";
+			await client.issues.createComment(repo, created.number, `${who} commented on ${comment.createdAt}:\n\n${comment.body}`);
+		}
+		if (record.closed) await client.issues.updateIssue(repo, created.number, {
+			state: "closed",
+			state_reason: "completed"
+		});
+		results.push({
+			source: record.key,
+			key: `#${created.number}`,
+			created: true,
+			dropped
+		});
+	}
+	return results;
+}
+function withProvenance(record) {
+	return `${record.body ? `${record.body}\n\n` : ""}---\n_Migrated from [${record.key}](${record.url}); created ${record.createdAt}._\n<!-- holocron:migrated-from ${record.url} -->`;
+}
+function parseNumber(key) {
+	const n = key.trim().replace(/^.*#/, "");
+	if (!/^\d+$/.test(n)) throw new Error(`Invalid GitHub issue key "${key}" — expected #N or N.`);
+	return parseInt(n, 10);
+}
+async function listAll(client, repo, extra) {
+	const all = [];
+	for (let page = 1;; page++) {
+		const batch = await client.issues.listIssues(repo, {
+			state: "all",
+			per_page: 100,
+			page,
+			...extra
+		});
+		all.push(...batch);
+		if (batch.length < 100) return all;
+	}
+}
+async function findMilestone(client, repo, ref) {
+	return (await client.issues.listMilestones(repo, { state: "all" })).find((m) => String(m.number) === ref || m.title.toLowerCase() === ref.toLowerCase());
+}
+async function ensureMilestone(client, repo, title) {
+	return (await findMilestone(client, repo, title))?.number ?? (await client.issues.createMilestone(repo, title)).number;
+}
 // src/capabilities/issues.ts
 /** The GitHub implementation of the `issues` capability, backed by GitHub Issues and status labels. */
 var GitHubIssues = class {
@@ -327,6 +487,14 @@ var GitHubIssues = class {
 			lifecycle
 		};
 	}
+	/** Reads issues with their comments, priority label, parent and blockers, for `holocron migrate`. */
+	export(selector) {
+		return exportIssues(this.client, this.repo, selector);
+	}
+	/** Makes the records as issues; one already made by an earlier run is skipped. */
+	import(records, options) {
+		return importIssues(this.client, this.repo, records, options);
+	}
 	async resolveMilestone(ref) {
 		if (/^\d+$/.test(ref)) return parseInt(ref, 10);
 		const match = (await this.client.issues.listMilestones(this.repo, { state: "all" })).find((m) => m.title.toLowerCase() === ref.toLowerCase());
@@ -381,6 +549,18 @@ function parseIssueNumber(key, owner, repoName) {
 const STATUS_FIELD = "Status";
 /** The name of the field `move` carries over besides the status. */
 const PRIORITY_FIELD = "Priority";
+const P_LEVELS = {
+	p0: "urgent",
+	p1: "high",
+	p2: "medium",
+	p3: "low"
+};
+/** The neutral priority a `Priority` option stands for, by its name; undefined for a name that is not one of them. */
+function priorityOf(value) {
+	const name = value?.trim().toLowerCase();
+	if (name === "urgent" || name === "high" || name === "medium" || name === "low") return name;
+	return name ? P_LEVELS[name] : void 0;
+}
 const PROJECT_FIELDS = "id number title closed url";
 const BOARD_QUERY = `query($id: ID!) { node(id: $id) { ... on ProjectV2 {
 	${PROJECT_FIELDS}
@@ -693,13 +873,15 @@ var GitHubProjects = class {
 		return (await this.fetchItems(board.id)).map((i) => {
 			const status = i.values[STATUS_FIELD];
 			const category = status ? categories.get(status) : void 0;
+			const priority = priorityOf(i.values[PRIORITY_FIELD]);
 			return {
 				key: this.keyOf(i.repo, i.number),
 				title: i.title,
 				open: i.open,
 				...status ? { status } : {},
 				...category ? { category } : {},
-				blockedBy: i.blockers.map((b) => this.keyOf(b.repo, b.number))
+				blockedBy: i.blockers.map((b) => this.keyOf(b.repo, b.number)),
+				...priority ? { priority } : {}
 			};
 		});
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-github",
-  "version": "5.0.0-alpha.369",
+  "version": "5.0.0-alpha.370",
   "description": "Holocron plugin for GitHub. Implements source, ci, secrets, environments, and issues capabilities against the GitHub REST API.",
   "keywords": [
     "ci",
@@ -35,30 +35,30 @@
   },
   "devDependencies": {
     "@types/node": "^26",
-    "@vitest/coverage-v8": "^5.0.5",
+    "@vitest/coverage-v8": "^5.1.0",
     "@vitest/eslint-plugin": "^1.6.28",
     "eslint": "^10.14.0",
     "eslint-plugin-n": "^18.5.0",
     "globals": "^17.14.0",
-    "tsdown": "^0.23.4",
+    "tsdown": "^0.23.5",
     "tsx": "4.23.15",
     "typescript": "^5.9.3",
-    "vitest": "^5.0.5",
-    "@theholocron/cli": "5.0.0-alpha.369",
+    "vitest": "^5.1.0",
+    "@theholocron/cli": "5.0.0-alpha.370",
     "@theholocron/eslint-config": "^8.9.0-alpha.11",
     "@theholocron/fs-utils": "^1.17.0-alpha.2",
-    "@theholocron/github-client": "^1.58.0-alpha.16",
+    "@theholocron/github-client": "^1.58.0-alpha.17",
     "@theholocron/misc-utils": "^1.17.0-alpha.2",
     "@theholocron/tsconfig": "^8.9.0-alpha.11",
-    "@theholocron/http-client": "^1.58.0-alpha.16",
     "@theholocron/tsdown-config": "^8.9.0-alpha.11",
+    "@theholocron/http-client": "^1.58.0-alpha.17",
     "@theholocron/vitest-config": "^8.9.0-alpha.11"
   },
   "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.369"
+    "@theholocron/cli": "5.0.0-alpha.370"
   },
   "engines": {
     "node": ">=22"