@theholocron/holocron-plugin-github 2.0.0-alpha.41 → 2.0.0-alpha.42

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Auth, AuthError, Ci, CiRun, CiRunFilter, Environment, Environments, Issue, IssueSearchFilter, Issues, LifecycleResult, LifecycleSlot, RepoRef, RepoSettings, ResolveTokenInput, RestClient, RestClient as RestClient$1, Ruleset, SecretScope, Secrets, Source, TrackerDoctorReport, TrackerUser } from "@theholocron/cli";
+import { Auth, AuthError, Ci, CiRun, CiRunFilter, Environment, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, RepoRef, RepoSettings, ResolveTokenInput, RestClient, RestClient as RestClient$1, Ruleset, SecretScope, Secrets, Source, TrackerDoctorReport, TrackerUser } from "@theholocron/cli";
 
 //#region src/auth.d.ts
 declare const resolveToken: (input?: import("@theholocron/http-client").ResolveTokenInput) => string;
@@ -54,6 +54,7 @@ declare class GitHubSource implements Source {
   writeWorkflowFile(name: string, contents: string): Promise<void>;
   removeWorkflowFile(name: string): Promise<void>;
   writeRepoFile(path: string, contents: string): Promise<void>;
+  syncLabels(canonical: ReadonlyArray<LabelDef>, stale: ReadonlyArray<string>): Promise<string>;
 }
 //#endregion
 //#region src/capabilities/secrets.d.ts
@@ -155,6 +156,22 @@ declare class GitHubIssues implements Issues {
   private mapIssue;
 }
 //#endregion
+//#region src/capabilities/labels.d.ts
+interface CanonicalLabel {
+  readonly name: string;
+  readonly color: string;
+  readonly description: string;
+}
+/**
+ * Idempotently synchronise a repo's labels to the canonical set.
+ *
+ * - Creates labels that are missing.
+ * - PATCHes labels whose color or description has drifted.
+ * - DELETEs labels listed in `stale`.
+ * - Leaves unrecognised labels that aren't in `stale` untouched.
+ */
+declare function syncLabels(rest: RestClient, repo: string, canonical: ReadonlyArray<CanonicalLabel>, stale: ReadonlyArray<string>): Promise<string>;
+//#endregion
 //#region src/verify-token.d.ts
 /**
  * `verifyToken` — plugin-level export used by `holocron auth set` +
@@ -228,4 +245,4 @@ declare function createPlugin(options: GitHubPluginOptions): {
  */
 declare const AUTH_HINT: string;
 //#endregion
-export { AUTH_HINT, type Auth, AuthError, GitHubCi, GitHubEnvironments, GitHubIssues, GitHubPluginOptions, GitHubSecrets, GitHubSource, PluginContext, type ResolveTokenInput, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, ci, createContext, createGitHubRestClient, createPlugin, encryptSecret, environments, issues, resolveToken, secrets, source, verifyToken };
+export { AUTH_HINT, type Auth, AuthError, type CanonicalLabel, GitHubCi, GitHubEnvironments, GitHubIssues, GitHubPluginOptions, GitHubSecrets, GitHubSource, PluginContext, type ResolveTokenInput, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, ci, createContext, createGitHubRestClient, createPlugin, encryptSecret, environments, issues, resolveToken, secrets, source, syncLabels, verifyToken };

package/dist/index.mjs

@@ -436,6 +436,53 @@ var GitHubSecrets = class {
 	}
 };
 //#endregion
+//#region src/capabilities/labels.ts
+/**
+* Idempotently synchronise a repo's labels to the canonical set.
+*
+* - Creates labels that are missing.
+* - PATCHes labels whose color or description has drifted.
+* - DELETEs labels listed in `stale`.
+* - Leaves unrecognised labels that aren't in `stale` untouched.
+*/
+async function syncLabels(rest, repo, canonical, stale) {
+	const { owner, name } = parseRepo(repo);
+	const base = `/repos/${owner}/${name}`;
+	const existing = await rest.request(`${base}/labels?per_page=100`);
+	const existingMap = new Map(existing.map((l) => [l.name.toLowerCase(), l]));
+	let created = 0;
+	let updated = 0;
+	let deleted = 0;
+	for (const label of canonical) {
+		const current = existingMap.get(label.name);
+		if (!current) {
+			await rest.request(`${base}/labels`, {
+				method: "POST",
+				body: {
+					name: label.name,
+					color: label.color,
+					description: label.description
+				}
+			});
+			created++;
+		} else if (current.color !== label.color || (current.description ?? "") !== label.description) {
+			await rest.request(`${base}/labels/${encodeURIComponent(label.name)}`, {
+				method: "PATCH",
+				body: {
+					color: label.color,
+					description: label.description
+				}
+			});
+			updated++;
+		}
+	}
+	for (const staleName of stale) if (existingMap.has(staleName)) {
+		await rest.request(`${base}/labels/${encodeURIComponent(staleName)}`, { method: "DELETE" });
+		deleted++;
+	}
+	return `${created} created, ${updated} updated, ${deleted} deleted`;
+}
+//#endregion
 //#region src/capabilities/source.ts
 /**
 * `source` capability for GitHub.
@@ -590,6 +637,9 @@ var GitHubSource = class {
 		await ensureDir(dirname(full));
 		await writeFile(full, contents, "utf8");
 	}
+	async syncLabels(canonical, stale) {
+		return syncLabels(this.rest, `${this.owner}/${this.name}`, canonical, stale);
+	}
 };
 function isENOENT(err) {
 	return typeof err === "object" && err !== null && "code" in err && err.code === "ENOENT";
@@ -705,4 +755,4 @@ function createPlugin(options) {
 */
 const AUTH_HINT = "generate a Personal Access Token at https://github.com/settings/tokens (scopes: repo, admin:repo_hook — plus admin:org for org-level ops), then run: holocron auth set github <PAT>";
 //#endregion
-export { AUTH_HINT, AuthError, GitHubCi, GitHubEnvironments, GitHubIssues, GitHubSecrets, GitHubSource, ci, createContext, createGitHubRestClient, createPlugin, encryptSecret, environments, issues, resolveToken, secrets, source, verifyToken };
+export { AUTH_HINT, AuthError, GitHubCi, GitHubEnvironments, GitHubIssues, GitHubSecrets, GitHubSource, ci, createContext, createGitHubRestClient, createPlugin, encryptSecret, environments, issues, resolveToken, secrets, source, syncLabels, verifyToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-github",
-  "version": "2.0.0-alpha.41",
+  "version": "2.0.0-alpha.42",
   "description": "Holocron plugin for GitHub. Implements source, ci, secrets, environments, and issues capabilities against the GitHub REST API.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/holocron-plugin-github#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",
@@ -21,7 +21,7 @@
     }
   },
   "peerDependencies": {
-    "@theholocron/cli": "2.0.0-alpha.41"
+    "@theholocron/cli": "2.0.0-alpha.42"
   },
   "dependencies": {
     "libsodium-wrappers": "^0.7.15"
@@ -41,7 +41,7 @@
     "tsx": "^4.22.4",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@theholocron/cli": "2.0.0-alpha.41"
+    "@theholocron/cli": "2.0.0-alpha.42"
   },
   "publishConfig": {
     "access": "public"