@theholocron/holocron-plugin-github 5.0.0-alpha.372 → 5.0.0-alpha.374

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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 { AddedItem, Auth, AuthError, BoardItem, BoardItemInput, 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;
@@ -179,6 +179,16 @@ export declare class GitHubProjects implements Projects {
    * closed and merged ones stay, and are set to the template's done status when theirs is not a done one.
    */
   move(_owner: string, from: BoardSummary, to: BoardSummary, template: BoardTemplate): Promise<MoveReport>;
+  /**
+   * Puts issues on the board (`addProjectV2ItemById`, the content id the issue's node id) and sets Status and Priority
+   * through the single select update, only where the item has no value yet. A status or priority with no option on
+   * the board is reported in `dropped`; no option is ever created, so no value is cleared.
+   */
+  addItems(_owner: string, board: BoardSummary, items: BoardItemInput[], template: BoardTemplate): Promise<AddedItem[]>;
+  /** The board's own status for an input: the option named like its status, else the template's status of its category. */
+  private statusFor;
+  /** The node id of an issue, which `addProjectV2ItemById` takes as the content id. */
+  private nodeId;
   /** A `holocron doctor` smoke check: how many boards the token sees in the configured repository's organization. */
   whoami(): Promise<{
     ok: boolean;

package/dist/index.mjs

@@ -957,6 +957,72 @@ var GitHubProjects = class {
 		}
 		return report;
 	}
+	/**
+	* Puts issues on the board (`addProjectV2ItemById`, the content id the issue's node id) and sets Status and Priority
+	* through the single select update, only where the item has no value yet. A status or priority with no option on
+	* the board is reported in `dropped`; no option is ever created, so no value is cleared.
+	*/
+	async addItems(_owner, board, items, template) {
+		const raw = await this.readRaw(board.id);
+		const onBoard = await this.fetchItems(board.id);
+		const statusField = raw.fields.find((f) => f.name === STATUS_FIELD && f.options);
+		const priorityField = raw.fields.find((f) => f.name === PRIORITY_FIELD && f.options);
+		const results = [];
+		for (const input of items) {
+			const ref = this.parseKey(input.key);
+			let current = onBoard.find((i) => i.repo === ref.repo && i.number === ref.number);
+			const added = !current;
+			if (!current) current = {
+				id: (await this.graphql.query(`mutation($project: ID!, $content: ID!) { addProjectV2ItemById(input: { projectId: $project, contentId: $content }) { item { id } } }`, {
+					project: board.id,
+					content: await this.nodeId(ref)
+				})).addProjectV2ItemById.item.id,
+				contentId: "",
+				repo: ref.repo,
+				number: ref.number,
+				title: "",
+				open: true,
+				values: {},
+				blockers: []
+			};
+			const dropped = [];
+			if (input.status !== void 0 || input.category !== void 0) {
+				const name = this.statusFor(input, template, statusField?.options);
+				if (!name) dropped.push(`status ${input.status ?? input.category} (no matching option on the board)`);
+				else if (!current.values[STATUS_FIELD]) await this.setOption(board.id, raw, current.id, STATUS_FIELD, name);
+			}
+			if (input.priority !== void 0 && input.priority !== "none") {
+				const option = priorityField?.options?.find((o) => priorityOf(o.name) === input.priority);
+				if (!option) dropped.push(`priority ${input.priority} (no matching option on the board)`);
+				else if (!current.values[PRIORITY_FIELD]) await this.setOption(board.id, raw, current.id, PRIORITY_FIELD, option.name);
+			}
+			results.push({
+				key: input.key,
+				added,
+				dropped
+			});
+		}
+		return results;
+	}
+	/** The board's own status for an input: the option named like its status, else the template's status of its category. */
+	statusFor(input, template, options) {
+		const has = (name) => options?.find((o) => o.name.toLowerCase() === name.toLowerCase())?.name;
+		const named = input.status === void 0 ? void 0 : has(input.status);
+		if (named) return named;
+		const byCategory = template.statuses.find((s) => s.category === input.category);
+		return byCategory ? has(byCategory.name) : void 0;
+	}
+	/** The node id of an issue, which `addProjectV2ItemById` takes as the content id. */
+	async nodeId(ref) {
+		const [owner, name] = ref.repo.split("/");
+		const id = (await this.graphql.query(`query($owner: String!, $name: String!, $number: Int!) { repository(owner: $owner, name: $name) { issue(number: $number) { id } } }`, {
+			owner,
+			name,
+			number: ref.number
+		})).repository?.issue?.id;
+		if (!id) throw new Error(`issue ${ref.repo}#${ref.number} not found`);
+		return id;
+	}
 	/** A `holocron doctor` smoke check: how many boards the token sees in the configured repository's organization. */
 	async whoami() {
 		try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-github",
-  "version": "5.0.0-alpha.372",
+  "version": "5.0.0-alpha.374",
   "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.372",
+    "@theholocron/cli": "5.0.0-alpha.374",
     "@theholocron/eslint-config": "^8.9.0-alpha.12",
     "@theholocron/fs-utils": "^1.17.0-alpha.2",
-    "@theholocron/http-client": "^1.58.0-alpha.19",
+    "@theholocron/http-client": "^1.58.0-alpha.20",
     "@theholocron/misc-utils": "^1.17.0-alpha.2",
-    "@theholocron/tsdown-config": "^8.9.0-alpha.12",
     "@theholocron/tsconfig": "^8.9.0-alpha.12",
-    "@theholocron/github-client": "^1.58.0-alpha.19",
+    "@theholocron/github-client": "^1.58.0-alpha.20",
+    "@theholocron/tsdown-config": "^8.9.0-alpha.12",
     "@theholocron/vitest-config": "^8.9.0-alpha.12"
   },
   "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.372"
+    "@theholocron/cli": "5.0.0-alpha.374"
   },
   "engines": {
     "node": ">=22"