@theholocron/holocron-plugin-github 5.0.0-alpha.394 → 5.0.0-alpha.395

package/dist/index.d.mts

@@ -86,8 +86,18 @@ export declare class GitHubIssues implements Issues {
   private readonly labels;
   constructor(client: GitHubClient, opts: IssuesOptions);
   getMyself(): Promise<TrackerUser>;
-  /** Searches the repo's issues, newest update first, leaving out pull requests. */
+  /**
+   * Searches the repo's issues, newest update first, leaving out pull requests.
+   *
+   * With `filter.text`, the issues are paged (newest update first, 100 a page, at most 20 pages) and compared
+   * client-side, without regard to case, until `limit` matches are found or the issues run out. GitHub's issue
+   * search (`GET /search/issues`) is deliberately not used: it indexes the words of a body, so punctuation and an
+   * HTML comment such as `<!-- holocron:idea notes/a.md -->` cannot be relied on to match, it is limited to 30
+   * requests a minute and it is eventually consistent (an issue made a moment ago may be missing). Paging has none
+   * of those limits, at the cost of reading up to 20 pages of a very large repository.
+   */
   search(filter: IssueSearchFilter): Promise<Issue[]>;
+  private searchText;
   /** Fetches one issue by its key. */
   get(key: string): Promise<Issue>;
   /** Creates an issue and returns its key as `#<number>`; the milestone is resolved from its title. */

package/dist/index.mjs

@@ -483,6 +483,10 @@ async function update(client, repo, issue, record, options) {
 	};
 }
 // src/capabilities/issues.ts
+/** Issues read per request when `search` has a `text`; GitHub's largest page. */
+const TEXT_PAGE_SIZE = 100;
+/** Pages `search` reads for a `text` before it stops (the 2000 most recently updated issues). */
+const TEXT_MAX_PAGES = 20;
 /** The GitHub implementation of the `issues` capability, backed by GitHub Issues and status labels. */
 var GitHubIssues = class {
 	client;
@@ -510,8 +514,18 @@ var GitHubIssues = class {
 			...raw.email ? { emailAddress: raw.email } : {}
 		};
 	}
-	/** Searches the repo's issues, newest update first, leaving out pull requests. */
+	/**
+	* Searches the repo's issues, newest update first, leaving out pull requests.
+	*
+	* With `filter.text`, the issues are paged (newest update first, 100 a page, at most 20 pages) and compared
+	* client-side, without regard to case, until `limit` matches are found or the issues run out. GitHub's issue
+	* search (`GET /search/issues`) is deliberately not used: it indexes the words of a body, so punctuation and an
+	* HTML comment such as `<!-- holocron:idea notes/a.md -->` cannot be relied on to match, it is limited to 30
+	* requests a minute and it is eventually consistent (an issue made a moment ago may be missing). Paging has none
+	* of those limits, at the cost of reading up to 20 pages of a very large repository.
+	*/
 	async search(filter) {
+		if (filter.text) return this.searchText(filter, filter.text);
 		const params = {
 			state: filter.openOnly ? "open" : "all",
 			sort: "updated",
@@ -530,6 +544,32 @@ var GitHubIssues = class {
 			assignee: params.assignee
 		})).filter((i) => !i.pull_request).map((i) => this.mapIssue(i));
 	}
+	async searchText(filter, text) {
+		const needle = text.toLowerCase();
+		const limit = filter.limit ?? 50;
+		const assignee = filter.assignee === "currentUser" ? (await this.getMyself()).id : filter.assignee || void 0;
+		const found = [];
+		for (let page = 1; page <= TEXT_MAX_PAGES; page++) {
+			const raw = await this.client.issues.listIssues(this.repo, {
+				state: filter.openOnly ? "open" : "all",
+				sort: "updated",
+				direction: "desc",
+				per_page: TEXT_PAGE_SIZE,
+				page,
+				filter: "all",
+				...assignee ? { assignee } : {}
+			});
+			for (const issue of raw) {
+				if (issue.pull_request) continue;
+				if (`${issue.title}\n${issue.body ?? ""}`.toLowerCase().includes(needle)) {
+					found.push(this.mapIssue(issue));
+					if (found.length >= limit) return found;
+				}
+			}
+			if (raw.length < TEXT_PAGE_SIZE) break;
+		}
+		return found;
+	}
 	/** Fetches one issue by its key. */
 	async get(key) {
 		const number = parseIssueNumber(key, this.owner, this.repoName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-github",
-  "version": "5.0.0-alpha.394",
+  "version": "5.0.0-alpha.395",
   "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.394",
-    "@theholocron/eslint-config": "^8.9.0-alpha.15",
+    "@theholocron/cli": "5.0.0-alpha.395",
     "@theholocron/fs-utils": "^1.17.0-alpha.3",
-    "@theholocron/github-client": "^1.58.0-alpha.25",
-    "@theholocron/tsconfig": "^8.9.0-alpha.15",
     "@theholocron/misc-utils": "^1.17.0-alpha.3",
-    "@theholocron/http-client": "^1.58.0-alpha.25",
+    "@theholocron/tsconfig": "^8.9.0-alpha.15",
+    "@theholocron/eslint-config": "^8.9.0-alpha.15",
     "@theholocron/tsdown-config": "^8.9.0-alpha.15",
-    "@theholocron/vitest-config": "^8.9.0-alpha.15"
+    "@theholocron/http-client": "^1.58.0-alpha.27",
+    "@theholocron/vitest-config": "^8.9.0-alpha.15",
+    "@theholocron/github-client": "^1.58.0-alpha.27"
   },
   "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.394"
+    "@theholocron/cli": "5.0.0-alpha.395"
   },
   "engines": {
     "node": ">=22"