@gitkraken/core-gitlens 0.5.103 → 0.5.105

package/dist/plus/integrations/reads/counts.d.ts

@@ -0,0 +1,64 @@
+import type { IssueSearchCriteria } from '../../../git/models/issue.js';
+import type { IntegrationIds } from '../constants.js';
+import type { ProviderReposInput } from '../providers/models.js';
+import type { ProviderResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+/**
+ * One scope to count.
+ *
+ * `key` is caller-owned and echoed back verbatim, so a batch result needs no positional matching by the consumer.
+ * It never reaches the provider query — the aliases in the upstream document are generated — so it can be any
+ * string the caller finds meaningful.
+ */
+export interface IssueCountScope {
+    key: string;
+    /** Repositories to count over. Combines with `org`, exactly as in `searchIssuesPage`. */
+    repos?: ProviderReposInput;
+    org?: string;
+    /** Same criteria model as `searchIssuesPage`, validated against the same capability table. */
+    criteria?: IssueSearchCriteria;
+}
+/** The count for one {@link IssueCountScope}, echoed back under the caller's own `key`. */
+export interface IssueCountResult {
+    key: string;
+    /**
+     * Total matches the provider reports. `undefined` when the provider didn't report one for this scope — NEVER
+     * zero, which is a real answer. Render the difference: an unreported count means "unknown", and showing it as
+     * 0 would tell the user this filter matches nothing.
+     */
+    count?: number;
+    /**
+     * True when `count` exceeds the provider's own result ceiling, so a full read CANNOT return everything no
+     * matter how it is paged. This is the signal to warn before starting an expensive fetch.
+     */
+    exceedsProviderLimit: boolean;
+    /** The ceiling itself, when the provider declares one. */
+    providerLimit?: number;
+}
+/**
+ * Counts issues for many scopes without fetching any — the probe behind a "this will fetch ~N issues" preview.
+ *
+ * A distinct method rather than a `countOnly` flag on `searchIssuesPage`, because transferring ZERO issues is the
+ * entire value: a flag would return a paged result whose `items`, `cursor` and `hasMore` are all meaningless, and
+ * every consumer would have to know which fields to ignore. A separate method has a return type that only
+ * describes counts.
+ *
+ * Scopes are batched into as few upstream requests as possible ({@link issueCountChunkSize} each). A chunk that
+ * fails warns and drops only its own scopes, leaving the successful chunks' counts intact — so a partial answer is
+ * still useful — with `fetchFailed` set. A scope refused for its own reasons (unscoped, inexpressible criteria) is
+ * likewise isolated: its siblings are still counted.
+ *
+ * Cheap is not free: each chunk is a network request, so a caller driving this from UI state is expected to
+ * debounce and cache.
+ */
+export declare function countIssues(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    scopes: readonly IssueCountScope[];
+    connectionId?: string;
+    /**
+     * Explicit self-managed host domain. Used only when the requested connection has no configured domain;
+     * it must come from the trusted authentication configuration, not repository or remote data.
+     */
+    domain?: string;
+}): Promise<ProviderResult<IssueCountResult>>;
+//# sourceMappingURL=counts.d.ts.map

package/dist/plus/integrations/reads/counts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/counts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,eAAe,CAAC;AAOrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAoBxD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,yFAAyF;IACzF,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,2FAA2F;AAC3F,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAC9B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CA4H3C"}

package/dist/plus/integrations/reads/counts.js

@@ -0,0 +1,164 @@
+import { chunk } from '../../../utils/array.js';
+import { mapBounded } from '../../../utils/promise.js';
+import { providerFanOutConcurrency } from '../constants.js';
+import { providersMetadata } from '../providers/models.js';
+import { appendDedupedWarning } from '../results.js';
+import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
+import { runCaptured } from './drains.js';
+import { resolveIssueSearchCriteria, resolveIssueSearchScope } from './filters.js';
+import { gitHostOnlySurfaceWarning, issuesUnsupportedWarning, otherWarning, unsupportedIssueSearchCriteriaWarning, } from './warnings.js';
+/**
+ * How many scopes go into one upstream request.
+ *
+ * Measured against the live GitHub API, 30 aliased counts cost a single rate-limit point and ~2s, and 60 cost the
+ * same point and roughly twice as long — so the constraint isn't rate limit, it's latency and the provider's
+ * (uncontracted, so not to be leaned on) query-complexity limits. 25 keeps a chunk comfortably inside both while
+ * still collapsing a realistic filter matrix into one or two requests.
+ */
+const issueCountChunkSize = 25;
+/**
+ * Counts issues for many scopes without fetching any — the probe behind a "this will fetch ~N issues" preview.
+ *
+ * A distinct method rather than a `countOnly` flag on `searchIssuesPage`, because transferring ZERO issues is the
+ * entire value: a flag would return a paged result whose `items`, `cursor` and `hasMore` are all meaningless, and
+ * every consumer would have to know which fields to ignore. A separate method has a return type that only
+ * describes counts.
+ *
+ * Scopes are batched into as few upstream requests as possible ({@link issueCountChunkSize} each). A chunk that
+ * fails warns and drops only its own scopes, leaving the successful chunks' counts intact — so a partial answer is
+ * still useful — with `fetchFailed` set. A scope refused for its own reasons (unscoped, inexpressible criteria) is
+ * likewise isolated: its siblings are still counted.
+ *
+ * Cheap is not free: each chunk is a network request, so a caller driving this from UI state is expected to
+ * debounce and cache.
+ */
+export async function countIssues(ctx, options) {
+    const refused = (warning) => ({
+        items: [],
+        warnings: [warning],
+        fetchFailed: true,
+    });
+    if (isIssuesHostIntegrationId(options.providerId)) {
+        return refused(gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Issue counts'));
+    }
+    // Nothing was asked for, so nothing is missing: an empty success, not a refusal.
+    if (options.scopes.length === 0)
+        return { items: [], warnings: [] };
+    const duplicateKey = findDuplicateKey(options.scopes);
+    if (duplicateKey != null) {
+        // Refuses the whole call rather than deduping: `key` exists so the caller can match results without
+        // positional bookkeeping, and two results under one key make that ambiguous for EVERY scope, not just the
+        // repeated one.
+        return refused(otherWarning(options.providerId, undefined, options.connectionId, `Duplicate issue count scope key '${duplicateKey}'; keys identify results, so each must be unique.`));
+    }
+    const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
+    if (integration == null) {
+        // A supplied connection or domain that no longer resolves is a broken target, not an empty account.
+        const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
+        return { items: [], warnings: early.warnings, fetchFailed: early.fetchFailed || undefined };
+    }
+    if (!isGitHostIntegration(integration)) {
+        return refused(gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'Issue counts'));
+    }
+    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
+    const warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);
+    if (!integration.supportsIssues) {
+        return refused(issuesUnsupportedWarning(options.providerId, domain, options.connectionId));
+    }
+    const providerLimit = providersMetadata[options.providerId]?.issueSearchResultLimit;
+    const warnings = [];
+    let fetchFailed = false;
+    // Validate every scope first, so a refusal costs no request at all and the countable ones are still batched
+    // together.
+    const countable = [];
+    for (const scope of options.scopes) {
+        const warning = rejectScope(options.providerId, domain, options.connectionId, scope);
+        if (warning != null) {
+            // `push`, not `appendDedupedWarning`: every rejection message embeds the scope's own key, and duplicate
+            // keys were already refused above, so no two of these can ever collapse — deduping them would only pay
+            // the O(n²) key comparison to prove it.
+            warnings.push(warning);
+            fetchFailed = true;
+            continue;
+        }
+        countable.push(scope);
+    }
+    // Chunks are independent requests over their own slice of scopes — nothing in one reads what another produced,
+    // and `runCaptured` never throws — so they run concurrently, bounded like every other fan-out on the facade.
+    // Sequentially they would spend exactly the resource this probe is tuned to conserve: latency, ~2s per chunk.
+    // `mapBounded` returns in input order, so `items` and `warnings` stay in scope order.
+    const batches = await mapBounded(chunk(countable, issueCountChunkSize), providerFanOutConcurrency, batch => runCaptured(options.providerId, domain, options.connectionId, () => integration.countIssuesResult(batch.map(s => ({
+        repos: s.repos,
+        org: s.org,
+        criteria: s.criteria,
+    })), undefined, options.connectionId), { warnOnMissingSession: warnOnMissingSession }).then(result => ({ batch: batch, ...result })));
+    const items = [];
+    for (const { batch, value, warning } of batches) {
+        if (warning != null) {
+            appendDedupedWarning(warnings, warning);
+        }
+        if (value == null) {
+            // This batch contributes nothing, but the batches around it still do. Drop only these scopes.
+            fetchFailed = true;
+            continue;
+        }
+        for (let i = 0; i < batch.length; i++) {
+            const count = value[i];
+            items.push({
+                key: batch[i].key,
+                count: count,
+                // Only a reported count can exceed a declared ceiling; unknown-vs-limit is not a comparison.
+                exceedsProviderLimit: count != null && providerLimit != null && count > providerLimit,
+                providerLimit: providerLimit,
+            });
+        }
+    }
+    // A provider with no count support returns `undefined` with no error, which lands as an empty `items` and no
+    // warning. Say so explicitly rather than letting it read as "every scope matched nothing".
+    if (items.length === 0 && warnings.length === 0) {
+        return refused(unsupportedIssueSearchCriteriaWarning(options.providerId, domain, options.connectionId, {
+            reason: 'unsupported-search',
+        }));
+    }
+    return { items: items, warnings: warnings, fetchFailed: fetchFailed || undefined };
+}
+/** The first key that appears twice, or `undefined` when every key is unique. */
+function findDuplicateKey(scopes) {
+    const seen = new Set();
+    for (const scope of scopes) {
+        if (seen.has(scope.key))
+            return scope.key;
+        seen.add(scope.key);
+    }
+    return undefined;
+}
+/**
+ * Why one scope can't be counted, as the warning to report — or `undefined` when it can.
+ *
+ * The scope and criteria rules come from {@link resolveIssueSearchScope} / {@link resolveIssueSearchCriteria},
+ * the same validators `searchIssuesPage` uses, so a count always previews the constraints the read would apply.
+ * That is not cosmetic: a count computed under different constraints is a WRONG number rather than a missing
+ * one, which is worse. Only the wording is local, because these name the offending scope's key.
+ */
+function rejectScope(providerId, domain, connectionId, scope) {
+    const scoping = resolveIssueSearchScope(scope.repos, scope.org, scope.criteria);
+    switch (scoping.rejection) {
+        case 'repo-ids':
+            return otherWarning(providerId, domain, connectionId, `Issue count scope '${scope.key}' cannot be scoped by repository id; pass repository descriptors (namespace + name) instead.`);
+        case 'unscoped':
+            return otherWarning(providerId, domain, connectionId, `Issue count scope '${scope.key}' is unscoped; pass \`repos\`, \`org\`, or a relationship to the current user. \`any-assignee\` and \`unassigned\` are not scopes.`);
+    }
+    const resolved = resolveIssueSearchCriteria(providerId, scope.criteria);
+    if (resolved.rejection != null) {
+        return unsupportedIssueSearchCriteriaWarning(providerId, domain, connectionId, resolved.rejection);
+    }
+    // Count-only, with no counterpart in the read: a relationship set is an OR across several searches, which one
+    // count can't express — summing them would double-count anything matching two, and taking the max would
+    // under-report. Rather than answer with a wrong number, ask the caller to count each relationship as its own
+    // scope, where the keys make the OR explicit.
+    if ((scope.criteria?.relationships?.length ?? 0) > 1) {
+        return otherWarning(providerId, domain, connectionId, `Issue count scope '${scope.key}' requests several relationships, which a single count can't express (they are OR-ed, so overlapping matches would be double-counted); pass one scope per relationship.`);
+    }
+    return undefined;
+}
+//# sourceMappingURL=counts.js.map

package/dist/plus/integrations/reads/counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counts.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/counts.ts"],"names":[],"mappings":"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"}

package/dist/plus/integrations/reads/filters.d.ts

@@ -1,5 +1,6 @@
 import type { IntegrationIds } from '../constants.js';
-import type { IssueFilter, PullRequestFilter } from '../providerFilters.js';
+import type { IssueFilter, IssueSearchCapabilities, IssueSearchCriteria, PullRequestFilter } from '../providerFilters.js';
+import type { ProviderRepoInput, ProviderReposInput } from '../providers/models.js';
 /**
  * Validation of a caller-supplied relationship filter set against what a provider can express server-side.
  *
@@ -43,6 +44,61 @@ export declare function resolveAccountWidePullRequestFilters(id: IntegrationIds,
  * `[Assignee]` asked for.
  */
 export declare function resolveAccountWideIssueFilters(id: IntegrationIds, filters: IssueFilter[] | undefined): ResolvedFilters<IssueFilter>;
+/** Why {@link resolveIssueSearchCriteria} refused a criteria set, so the caller can word the refusal exactly. */
+export type IssueSearchCriteriaRejection = 
+/** The provider has no filtered issue search at all. */
+{
+    reason: 'unsupported-search';
+}
+/** The provider has one, but can't express these criteria server-side. */
+ | {
+    reason: 'unsupported-criteria';
+    criteria: string[];
+}
+/** `any-assignee` and `unassigned` partition the scope between them; asking for both asks for nothing. */
+ | {
+    reason: 'contradictory-relationships';
+};
+/**
+ * Validates a filtered issue search's criteria against {@link ProviderMetadata.supportedIssueSearch}.
+ *
+ * All-or-nothing like its three siblings above, and for the same reason: a criterion dropped because the
+ * provider can't express it would serve a WIDER result than was asked for, and narrowing the returned page
+ * afterward would leave `items` describing a different result set than the `hasMore`/`cursor` the provider
+ * produced with it. So an inexpressible set is refused whole and the caller surfaces a warning.
+ *
+ * Unlike the sibling validators this also rejects a set that is internally contradictory, because this criteria
+ * model is the only one with two members that partition the scope between them (`any-assignee` ∪ `unassigned` =
+ * everything, ∩ = nothing). Silently keeping one would answer a question the caller didn't ask.
+ *
+ * `undefined` (or an empty relationship list plus no other criterion) is a valid UNNARROWED search of the given
+ * scope, not an error — the caller's `repos`/`org` is what bounds it.
+ */
+export declare function resolveIssueSearchCriteria(id: IntegrationIds, criteria: IssueSearchCriteria | undefined): {
+    rejection?: IssueSearchCriteriaRejection;
+};
+/** Why a filtered issue search's scope was refused, or `undefined` when it is usable. */
+export type IssueSearchScopeRejection = 
+/** No repositories, no org, and no user-relative relationship: a search of the whole host. */
+'unscoped'
+/** Repositories given as ids. A search names repositories by PATH, so ids can't express a scope. */
+ | 'repo-ids';
+/**
+ * Validates that a filtered issue search is scoped at all, and narrows `repos` to the descriptor form the
+ * provider query needs.
+ *
+ * Shared by `searchIssuesPage` and `countIssues` because a count computed under different constraints than the
+ * read it previews is a WRONG number rather than a missing one. The rejection is returned as a reason code, not a
+ * warning: the two callers word it differently (whole-read vs naming the offending scope's key), and wording is
+ * the warning layer's business.
+ *
+ * The two rejections are mutually exclusive — `repo-ids` requires repositories and `unscoped` requires none — so
+ * the order they're checked in cannot change the outcome.
+ */
+export declare function resolveIssueSearchScope(repos: ProviderReposInput | undefined, org: string | undefined, criteria: IssueSearchCriteria | undefined): {
+    rejection?: IssueSearchScopeRejection;
+    repos?: ProviderRepoInput[];
+};
 /**
  * The filters `listPullRequestsPage`/`listIssuesPage` (and the sweeps) accept for a provider, so a caller can
  * narrow to what the provider can express BEFORE issuing the read.
@@ -67,6 +123,11 @@ export declare function resolveAccountWideIssueFilters(id: IntegrationIds, filte
  * {@link IntegrationService.listIssueTrackerIssuesPage} validates against, and leaves `issuesAccountWide`
  * empty. Reading a tracker's capability off `issuesAccountWide` therefore under-reports it.
  *
+ * `issueSearch` is a third, wider surface: the FILTERED issue search (`searchIssuesPage`, and the `countIssues`
+ * probe over the same criteria), which is not bound to the user at all. It is a record of per-criterion flags
+ * rather than a list, because its criteria aren't a single kind. An empty `relationships` means the provider has
+ * no filtered issue search — hide the surface, not just its chips.
+ *
  * Note this is a CAPABILITY table — "what the provider can express" — not a recommendation. A consumer
  * matching another tool's behavior may deliberately pass fewer filters than are listed here (or none, where an
  * already-scoped read would only be narrowed by them). Intersecting against this table is what keeps a
@@ -77,5 +138,6 @@ export declare function getSupportedFilters(providerId: IntegrationIds): {
     pullRequestsAccountWide: PullRequestFilter[];
     issues: IssueFilter[];
     issuesAccountWide: IssueFilter[];
+    issueSearch: IssueSearchCapabilities;
 };
 //# sourceMappingURL=filters.d.ts.map

package/dist/plus/integrations/reads/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACtC,eAAe,CAAC,iBAAiB,CAAC,CAOpC;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACtC,eAAe,CAAC,iBAAiB,CAAC,CAOpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC7C,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,GAChC,eAAe,CAAC,WAAW,CAAC,CAO9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG;IAChE,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,uBAAuB,EAAE,iBAAiB,EAAE,CAAC;IAC7C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iBAAiB,EAAE,WAAW,EAAE,CAAC;CACjC,CAQA"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACX,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EAEnB,iBAAiB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGpF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACtC,eAAe,CAAC,iBAAiB,CAAC,CAOpC;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACtC,eAAe,CAAC,iBAAiB,CAAC,CAOpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC7C,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,GAChC,eAAe,CAAC,WAAW,CAAC,CAO9B;AAED,iHAAiH;AACjH,MAAM,MAAM,4BAA4B;AACvC,wDAAwD;AACtD;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE;AAClC,0EAA0E;GACxE;IAAE,MAAM,EAAE,sBAAsB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AACxD,0GAA0G;GACxG;IAAE,MAAM,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACzC,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,mBAAmB,GAAG,SAAS,GACvC;IAAE,SAAS,CAAC,EAAE,4BAA4B,CAAA;CAAE,CA4C9C;AAyBD,yFAAyF;AACzF,MAAM,MAAM,yBAAyB;AACpC,8FAA8F;AAC5F,UAAU;AACZ,oGAAoG;GAClG,UAAU,CAAC;AAEd;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,EAAE,mBAAmB,GAAG,SAAS,GACvC;IAAE,SAAS,CAAC,EAAE,yBAAyB,CAAC;IAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAYxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG;IAChE,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,uBAAuB,EAAE,iBAAiB,EAAE,CAAC;IAC7C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,WAAW,EAAE,uBAAuB,CAAC;CACrC,CAuBA"}

package/dist/plus/integrations/reads/filters.js

@@ -46,6 +46,111 @@ export function resolveAccountWideIssueFilters(id, filters) {
         return { unsupported: true };
     return { filters: filters, unsupported: false };
 }
+/**
+ * Validates a filtered issue search's criteria against {@link ProviderMetadata.supportedIssueSearch}.
+ *
+ * All-or-nothing like its three siblings above, and for the same reason: a criterion dropped because the
+ * provider can't express it would serve a WIDER result than was asked for, and narrowing the returned page
+ * afterward would leave `items` describing a different result set than the `hasMore`/`cursor` the provider
+ * produced with it. So an inexpressible set is refused whole and the caller surfaces a warning.
+ *
+ * Unlike the sibling validators this also rejects a set that is internally contradictory, because this criteria
+ * model is the only one with two members that partition the scope between them (`any-assignee` ∪ `unassigned` =
+ * everything, ∩ = nothing). Silently keeping one would answer a question the caller didn't ask.
+ *
+ * `undefined` (or an empty relationship list plus no other criterion) is a valid UNNARROWED search of the given
+ * scope, not an error — the caller's `repos`/`org` is what bounds it.
+ */
+export function resolveIssueSearchCriteria(id, criteria) {
+    const supported = providersMetadata[id]?.supportedIssueSearch;
+    if (supported == null)
+        return { rejection: { reason: 'unsupported-search' } };
+    if (criteria == null)
+        return {};
+    const relationships = criteria.relationships;
+    if (relationships?.includes('any-assignee') && relationships.includes('unassigned')) {
+        return { rejection: { reason: 'contradictory-relationships' } };
+    }
+    const unsupported = [];
+    for (const relationship of relationships ?? []) {
+        if (!supported.relationships.includes(relationship)) {
+            unsupported.push(`relationships:${relationship}`);
+        }
+    }
+    // Only a criterion the caller actually SET can be unsupported. `false`/empty means "don't narrow on this",
+    // which every provider can honor by doing nothing, so it must not be validated as a request.
+    if (criteria.text != null && criteria.text.trim().length > 0 && !supported.text) {
+        unsupported.push('text');
+    }
+    if (criteria.labels?.length && !supported.labels) {
+        unsupported.push('labels');
+    }
+    if (criteria.milestone != null && !supported.milestone) {
+        unsupported.push('milestone');
+    }
+    if (criteria.updatedAfter != null && !supported.updatedAfter) {
+        unsupported.push('updatedAfter');
+    }
+    if (criteria.createdAfter != null && !supported.createdAfter) {
+        unsupported.push('createdAfter');
+    }
+    if (criteria.withoutLinkedPullRequest === true && !supported.withoutLinkedPullRequest) {
+        unsupported.push('withoutLinkedPullRequest');
+    }
+    // `'open'` is every provider's own default, so asking for it needs no state capability.
+    if (criteria.state != null && criteria.state !== 'open' && !supported.states) {
+        unsupported.push('state');
+    }
+    if (unsupported.length > 0)
+        return { rejection: { reason: 'unsupported-criteria', criteria: unsupported } };
+    return {};
+}
+/**
+ * The relationships that bound a filtered issue search to the CURRENT USER, and so can stand in for a
+ * repository/org scope.
+ *
+ * Derived from the union rather than spelled out per call site, because the distinction it encodes is the whole
+ * reason the scope rule exists: `any-assignee` and `unassigned` are deliberately absent — they describe the
+ * ISSUE, not the caller, so neither reduces the search to anyone's own world (measured: unscoped `no:assignee`
+ * matches ~45 million issues on GitHub).
+ */
+const userScopingIssueSearchRelationships = ['authored', 'assigned', 'mentioned'];
+/** What a provider with NO filtered issue search reports: nothing expressible, spelled out rather than absent. */
+const unsupportedIssueSearchCapabilities = {
+    relationships: [],
+    text: false,
+    labels: false,
+    milestone: false,
+    updatedAfter: false,
+    createdAfter: false,
+    withoutLinkedPullRequest: false,
+    states: false,
+};
+/**
+ * Validates that a filtered issue search is scoped at all, and narrows `repos` to the descriptor form the
+ * provider query needs.
+ *
+ * Shared by `searchIssuesPage` and `countIssues` because a count computed under different constraints than the
+ * read it previews is a WRONG number rather than a missing one. The rejection is returned as a reason code, not a
+ * warning: the two callers word it differently (whole-read vs naming the offending scope's key), and wording is
+ * the warning layer's business.
+ *
+ * The two rejections are mutually exclusive — `repo-ids` requires repositories and `unscoped` requires none — so
+ * the order they're checked in cannot change the outcome.
+ */
+export function resolveIssueSearchScope(repos, org, criteria) {
+    if (repos?.length) {
+        // `ProviderReposInput` is a union of descriptor and id arrays; only the descriptor form is usable here.
+        if (repos.some(r => typeof r === 'string' || typeof r === 'number'))
+            return { rejection: 'repo-ids' };
+        return { repos: repos };
+    }
+    if (org != null && org.length > 0)
+        return {};
+    if (criteria?.relationships?.some(r => userScopingIssueSearchRelationships.includes(r)) === true)
+        return {};
+    return { rejection: 'unscoped' };
+}
 /**
  * The filters `listPullRequestsPage`/`listIssuesPage` (and the sweeps) accept for a provider, so a caller can
  * narrow to what the provider can express BEFORE issuing the read.
@@ -70,6 +175,11 @@ export function resolveAccountWideIssueFilters(id, filters) {
  * {@link IntegrationService.listIssueTrackerIssuesPage} validates against, and leaves `issuesAccountWide`
  * empty. Reading a tracker's capability off `issuesAccountWide` therefore under-reports it.
  *
+ * `issueSearch` is a third, wider surface: the FILTERED issue search (`searchIssuesPage`, and the `countIssues`
+ * probe over the same criteria), which is not bound to the user at all. It is a record of per-criterion flags
+ * rather than a list, because its criteria aren't a single kind. An empty `relationships` means the provider has
+ * no filtered issue search — hide the surface, not just its chips.
+ *
  * Note this is a CAPABILITY table — "what the provider can express" — not a recommendation. A consumer
  * matching another tool's behavior may deliberately pass fewer filters than are listed here (or none, where an
  * already-scoped read would only be narrowed by them). Intersecting against this table is what keeps a
@@ -77,11 +187,26 @@ export function resolveAccountWideIssueFilters(id, filters) {
  */
 export function getSupportedFilters(providerId) {
     const metadata = providersMetadata[providerId];
+    const issueSearch = metadata?.supportedIssueSearch;
     return {
         pullRequests: [...(metadata?.supportedPullRequestFilters ?? [])],
         pullRequestsAccountWide: [...(metadata?.supportedAccountWidePullRequestFilters ?? [])],
         issues: [...(metadata?.supportedIssueFilters ?? [])],
         issuesAccountWide: [...(metadata?.supportedAccountWideIssueFilters ?? [])],
+        // Always an object, never `undefined`: a provider WITHOUT a filtered issue search reports one whose
+        // `relationships` is empty and whose flags are all false, so a consumer reads capabilities the same way
+        // for every provider (and an empty `relationships` is the signal to hide the surface itself).
+        //
+        // Spread over the all-false baseline rather than defaulting each flag: a criterion added to
+        // `IssueSearchCapabilities` then can't be forgotten here and silently reported as `undefined` (which a
+        // consumer's `if (caps.x)` would read as unsupported — right answer, wrong reason, and untyped).
+        // `supportedIssueSearch` is typed as the complete shape, so no member can arrive as an explicit undefined.
+        issueSearch: {
+            ...unsupportedIssueSearchCapabilities,
+            ...issueSearch,
+            // Copied, so mutating the result can't corrupt the metadata table.
+            relationships: [...(issueSearch?.relationships ?? [])],
+        },
     };
 }
 //# sourceMappingURL=filters.js.map

package/dist/plus/integrations/reads/filters.js.map

@@ -1 +1 @@
-{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoB3D;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACxC,EAAkB,EAClB,OAAwC;IAExC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,2BAA2B,CAAC;IACrE,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CACnD,EAAkB,EAClB,OAAwC;IAExC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,sCAAsC,CAAC;IAChF,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B,CAC7C,EAAkB,EAClB,OAAkC;IAElC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,gCAAgC,CAAC;IAC1E,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA0B;IAM7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO;QACN,YAAY,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,2BAA2B,IAAI,EAAE,CAAC,CAAC;QAChE,uBAAuB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,sCAAsC,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACpD,iBAAiB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAgC,IAAI,EAAE,CAAC,CAAC;KAC1E,CAAC;AACH,CAAC"}
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"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"}

package/dist/plus/integrations/reads/issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAO1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAqBxD,wBAAsB,cAAc,CACnC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,sGAAsG;IACtG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAwW1C"}
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAO1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAsBxD,wBAAsB,cAAc,CACnC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,sGAAsG;IACtG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAgV1C"}

package/dist/plus/integrations/reads/issues.js

@@ -2,11 +2,11 @@ import { mergeAssessmentInto } from '../collectionMetadata.js';
 import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId } from '../constants.js';
 import { PagingMode, providersMetadata } from '../providers/models.js';
 import { mergeCollectionMetadata } from '../providers/utils/providerPaging.js';
-import { appendDedupedWarning, reconcileOmissionsWithFailure } from '../results.js';
+import { reconcileOmissionsWithFailure } from '../results.js';
 import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
 import { runCaptured } from './drains.js';
 import { resolveAccountWideIssueFilters } from './filters.js';
-import { drainToRequestedPage, isPageNumberAdvanceable, pageToCursor, refusedPage, resolveContinuation, resolveCurrentPage, toProviderPageInfo, usableCursor, } from './paging.js';
+import { drainFlatPagesToRequestedPage, drainToRequestedPage, isPageNumberAdvanceable, pageToCursor, refusedPage, resolveContinuation, resolveCurrentPage, toProviderPageInfo, usableCursor, } from './paging.js';
 import { gitHostOnlySurfaceWarning, issuesUnsupportedWarning, otherWarning, truncationWarning, unsupportedAccountWideIssueFiltersWarning, } from './warnings.js';
 export async function listIssuesPage(ctx, options) {
     const page = Math.max(1, options.page ?? 1);
@@ -43,6 +43,11 @@ export async function listIssuesPage(ctx, options) {
         if (options.filters?.length && options.includeAllAssignees === true) {
             return refused(otherWarning(options.providerId, domain, options.connectionId, '`filters` and `includeAllAssignees` are contradictory for an account-wide issue read; pass only one.'));
         }
+        // GitHub expresses "any assignee" as `assignee:*`, which is meaningless without a scope: unscoped it
+        // matches millions of issues across all of GitHub instead of the user's own world. ANY scope makes it
+        // meaningful (one repository, several, or an org) — it is specifically THIS branch, the account-wide read,
+        // that has none to offer. Scope the read to repositories (or use `searchIssuesPage`, whose criteria model
+        // takes `any-assignee` alongside a `repos`/`org` scope) rather than reading unscoped.
         if (options.includeAllAssignees === true &&
             (options.providerId === GitCloudHostIntegrationId.GitHub ||
                 options.providerId === GitSelfManagedHostIntegrationId.CloudGitHubEnterprise)) {
@@ -73,46 +78,22 @@ export async function listIssuesPage(ctx, options) {
             project: options.project,
         }), { warnOnMissingSession: warnOnMissingSession });
         const first = await readAccountWidePage(options.cursor);
-        let value = first.value;
         const warnings = first.warning != null ? [first.warning] : [];
-        let allMetadata = value?.metadata;
-        let pageFetchFailed = first.warning != null && value == null;
-        let currentPage = value?.page ?? 1;
-        let currentTruncated = value?.truncated ?? false;
-        let requestedPageMissing = false;
-        if (options.cursor == null && page > 1 && value != null) {
-            // Guard against the empty-cursor sentinel: a provider that claims another page without handing
-            // back a usable cursor would otherwise be re-read with `'{}'` and answer with page 1 again.
-            for (let nextCursor = usableCursor(value.cursor); currentPage < page && value.hasMore && nextCursor != null; nextCursor = usableCursor(value.cursor)) {
-                const next = await readAccountWidePage(nextCursor);
-                if (next.warning != null) {
-                    appendDedupedWarning(warnings, next.warning);
-                }
-                if (next.value == null) {
-                    pageFetchFailed = pageFetchFailed || next.warning != null;
-                    value = undefined;
-                    requestedPageMissing = true;
-                    break;
-                }
-                value = next.value;
-                allMetadata = mergeCollectionMetadata(allMetadata, value.metadata);
-                currentTruncated = currentTruncated || value.truncated;
-                currentPage = value.page ?? currentPage + 1;
-                // A provider that hands back the same cursor isn't advancing; stop rather than loop forever.
-                if (usableCursor(value.cursor) === nextCursor) {
-                    currentTruncated = true;
-                    break;
-                }
-            }
-            // A numbered page beyond the provider's terminal cursor is genuinely empty. Never return or
-            // relabel the last available page as the requested one.
-            if (currentPage < page) {
-                requestedPageMissing = true;
-            }
-        }
-        else if (options.cursor == null && page > 1) {
-            requestedPageMissing = true;
-        }
+        // Merged across the walked pages, so a per-scope failure reported on an earlier page isn't lost by
+        // paging past it — the one thing this read accumulates that the filtered search doesn't.
+        let allMetadata = first.value?.metadata;
+        const drained = await drainFlatPagesToRequestedPage(first, {
+            requestedPage: page,
+            suppliedCursor: options.cursor,
+            warnings: warnings,
+            readPage: readAccountWidePage,
+            fold: p => {
+                allMetadata = mergeCollectionMetadata(allMetadata, p.metadata);
+            },
+        });
+        const { value, currentPage, requestedPageMissing } = drained;
+        const currentTruncated = drained.truncated;
+        const pageFetchFailed = drained.fetchFailed;
         // GitHub, GitLab, and Azure implement an account-wide issue search; a provider that doesn't (Bitbucket
         // exposes no issues at all, and `supportsIssues` already short-circuits it above) returns `undefined`
         // with no error. Surface that as an explicit unsupported warning + fetchFailed rather than a silent