@gitkraken/core-gitlens 0.4.0 → 0.4.101

package/dist/plus/integrations/reads/hierarchy.utils.js

@@ -0,0 +1,128 @@
+import { IssuesCloudHostIntegrationId } from '../constants.js';
+import { appendDedupedWarning } from '../results.js';
+/**
+ * Mapping of a provider's own hierarchy vocabulary onto the single {@link ProviderOrganization} shape the facade
+ * publishes.
+ *
+ * Providers disagree about what sits above a repo or an issue: git hosts have orgs (and Azure DevOps a project
+ * tier below that), while issue trackers have "resources" (Jira sites, Linear orgs, Trello workspaces) with
+ * projects beneath them. `listOrgs`/`listProjects` unify all of it, so these helpers exist to keep the
+ * per-provider shape-guessing — which field is the id, which is the display label, which resource is a
+ * project's parent — in one place instead of inline in those reads.
+ *
+ * Everything here reads through the base {@link ResourceDescriptor} (which only guarantees `key`) and casts to
+ * the concrete {@link IssueResourceDescriptor} for the optional `id`/`name`. That cast is why the fallbacks are
+ * spelled out rather than assumed.
+ */
+/** The label to show for a resource: its name, else its id, else the key that is always present. */
+export function resourceLabel(resource) {
+    const typed = resource;
+    return typed.name ?? typed.id ?? resource.key;
+}
+/** Whether `org` addresses this resource by any of the identifiers a caller could reasonably have. */
+export function resourceMatchesOrg(resource, org) {
+    const typed = resource;
+    return resource.key === org || typed.id === org || typed.name === org;
+}
+/**
+ * The id of the RESOURCE a project belongs to, used to look up which account (and therefore which user) that
+ * project's issues should be scoped to. Falls back through the project's own identifiers because some providers
+ * (and test doubles) return project descriptors without naming their parent.
+ */
+export function resourceIdForProject(project) {
+    const typed = project;
+    return typed.resourceId ?? typed.id ?? project.key;
+}
+/**
+ * A stable identity for one project across facade pages, for the retry/completed bookkeeping an issue-tracker
+ * cursor carries. All three identifiers are included rather than one preferred value: two trackers can reuse the
+ * same project id, so keying on a single field would collapse them into one entry.
+ */
+export function projectKey(project) {
+    const typed = project;
+    return JSON.stringify([typed.resourceId ?? '', typed.id ?? '', project.key]);
+}
+/**
+ * Maps an issue-tracker resource descriptor to the unified {@link ProviderOrganization} org shape. `url` is
+ * synthesized when the descriptor carries none, rather than widening the shared `ProviderOrganization.url` to
+ * optional for the one provider family that may omit it.
+ */
+export function resourceToOrg(providerId, resource, org) {
+    const typed = resource;
+    return {
+        id: typed.id ?? resource.key,
+        providerId: providerId,
+        name: resourceLabel(resource),
+        ...(org != null ? { org: org } : {}),
+        url: typed.url ?? '',
+    };
+}
+/**
+ * The resource a project belongs under, as a display label — the `org` of the project's unified org shape.
+ *
+ * A project doesn't reliably name its parent, so try each identifier it does carry against the resources that
+ * were read alongside it. When none matches but only ONE resource was in scope, that resource is the parent by
+ * construction. Trello is excluded: its boards have no enclosing resource to name.
+ */
+export function orgForProject(providerId, project, resources) {
+    if (providerId === IssuesCloudHostIntegrationId.Trello)
+        return undefined;
+    const typedProject = project;
+    const parentMatch = [typedProject.resourceId, typedProject.id, project.key]
+        .filter((value) => value != null)
+        .map(candidate => resources.find(resource => resourceMatchesOrg(resource, candidate)))
+        .find((resource) => resource != null);
+    return parentMatch != null
+        ? resourceLabel(parentMatch)
+        : resources.length === 1
+            ? resourceLabel(resources[0])
+            : undefined;
+}
+/**
+ * Stamps the provider onto an org the provider's own client produced. A git host's client fills the rest of the
+ * shape but doesn't know which integration id it was reached through — and on a self-managed host the same
+ * client serves several — so the fan-out attributes it here.
+ */
+export function withProviderContext(providerId, item) {
+    return {
+        ...item,
+        providerId: providerId,
+        ...(item.org != null ? { org: item.org } : {}),
+    };
+}
+/**
+ * Merges the per-provider slices of a hierarchy fan-out into one flat result.
+ *
+ * `ProviderResult` has no page object, so `fetchFailed` is its only non-authoritative signal — any slice that
+ * failed or came back incomplete has to set it, or a caller would treat a short list as the whole account.
+ * Warnings are deduped because the same account can surface under two ids in one fan-out.
+ */
+export function mergeHierarchyResults(results) {
+    const items = [];
+    const warnings = [];
+    let fetchFailed = false;
+    for (const result of results) {
+        if (result == null)
+            continue;
+        items.push(...result.items);
+        for (const warning of result.warnings) {
+            appendDedupedWarning(warnings, warning);
+        }
+        if (result.fetchFailed) {
+            fetchFailed = true;
+        }
+    }
+    return { items: items, warnings: warnings, fetchFailed: fetchFailed || undefined };
+}
+/**
+ * Rejects a hierarchy read whose scoped selectors have no provider to apply to. `connectionId` and `domain`
+ * both select among the connections OF a provider, so either one without `providerId` is ambiguous rather than
+ * merely redundant — the fan-out would have to guess which provider the caller meant, and silently picking one
+ * would read that connection's data under another provider's name.
+ */
+export function assertHierarchyReadTarget(method, options) {
+    if (options?.providerId == null && (options?.connectionId != null || options?.domain != null)) {
+        throw new TypeError(`'${method}' requires 'providerId' when 'connectionId' or 'domain' is supplied`);
+    }
+}
+//# sourceMappingURL=hierarchy.utils.js.map

package/dist/plus/integrations/reads/hierarchy.utils.js.map

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

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

@@ -0,0 +1,19 @@
+import type { IssueShape } from '../../../git/models/issue.js';
+import type { IntegrationIds } from '../constants.js';
+import { IssueFilter } from '../providers/models.js';
+import type { ProviderPagedResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function listIssueTrackerIssuesPage(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    org?: string;
+    project?: string;
+    filters?: IssueFilter[];
+    /** Broadens the read to every assignee. Scopes to user-assigned issues when omitted. */
+    includeAllAssignees?: boolean;
+    forceSync?: boolean;
+    page?: number;
+    cursor?: string;
+    itemsPerPage?: number;
+    connectionId?: string;
+}): Promise<ProviderPagedResult<IssueShape>>;
+//# sourceMappingURL=issueTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issueTracker.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/issueTracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAqB,MAAM,wBAAwB,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAE1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMxD,wBAAsB,0BAA0B,CAC/C,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GACC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAkb1C"}

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

@@ -0,0 +1,334 @@
+import { mapBounded } from '../../../utils/promise.js';
+import { mergeAssessmentInto } from '../collectionMetadata.js';
+import { providerFanOutConcurrency } from '../constants.js';
+import { isIssuesIntegration } from '../models/issuesIntegration.js';
+import { IssueFilter, providersMetadata } from '../providers/models.js';
+import { mergeCollectionMetadata, parsePageCursor } from '../providers/utils/providerPaging.js';
+import { isIssuesHostIntegrationId } from '../utils/integration.utils.js';
+import { parseIssueTrackerPageCursor, toIssueTrackerPageCursor } from './cursors.js';
+import { runCaptured } from './drains.js';
+import { projectKey, resourceIdForProject, resourceLabel, resourceMatchesOrg } from './hierarchy.utils.js';
+import { issueTrackerOnlySurfaceWarning, otherWarning } from './warnings.js';
+export async function listIssueTrackerIssuesPage(ctx, options) {
+    // Pagination is opt-in: only window the projects when the caller actually asked to page. A caller that
+    // passes none of page/cursor/itemsPerPage keeps the "aggregate every matched project" contract, so an
+    // existing consumer that doesn't inspect `hasMore` never silently loses projects past a default window.
+    const compositeCursor = parseIssueTrackerPageCursor(options.cursor);
+    const paginated = compositeCursor?.unpaged !== true &&
+        (options.page != null || options.cursor != null || options.itemsPerPage != null);
+    // A composite cursor can carry retries from earlier project windows alongside the next untouched window.
+    // `currentPage` remains the caller-facing position; `nextPage` is the window this round should advance.
+    const page = Math.max(1, Math.trunc(compositeCursor?.currentPage ?? parsePageCursor(options.cursor) ?? options.page ?? 1));
+    const projectsPerPage = Math.max(1, Math.trunc(options.itemsPerPage ?? 20));
+    const items = [];
+    const warnings = [];
+    const emptyPage = (fetchFailed, truncated, retry) => {
+        const cursor = retry != null
+            ? toIssueTrackerPageCursor({
+                currentPage: page + 1,
+                unpaged: !paginated,
+                nextPage: retry.nextPage,
+                retryPages: retry.pages ?? [],
+                retryProjects: retry.projects ?? [],
+                completedProjects: retry.completedProjects ?? [],
+            })
+            : undefined;
+        return {
+            items: items,
+            warnings: warnings,
+            page: { currentPage: page, itemsPerPage: items.length, truncated: truncated || undefined },
+            // Retry-only state is deliberately manual: advertising it as forward progress would make a
+            // persistent provider failure spin forever in a normal `while (hasMore)` consumer. An untouched
+            // project window remains normal forward progress even when this window failed completely.
+            hasMore: retry?.nextPage != null && cursor != null,
+            cursor: cursor,
+            fetchFailed: fetchFailed || undefined,
+        };
+    };
+    const normalWindowPage = paginated
+        ? (compositeCursor?.nextPage ?? (compositeCursor == null ? page : undefined))
+        : undefined;
+    const priorRetryPages = compositeCursor?.retryPages ?? [];
+    const priorRetryProjects = compositeCursor?.retryProjects ?? [];
+    const priorCompletedProjects = compositeCursor?.completedProjects ?? [];
+    const trackCompletedProjects = priorCompletedProjects.length > 0 || priorRetryPages.length > 0 || compositeCursor?.completedProjects != null;
+    const retryPagesForDiscoveryFailure = () => [
+        ...priorRetryPages,
+        ...(normalWindowPage != null ? [normalWindowPage] : compositeCursor == null ? [1] : []),
+    ];
+    const discoveryFailureRetry = () => ({
+        pages: retryPagesForDiscoveryFailure(),
+        projects: priorRetryProjects,
+        completedProjects: priorCompletedProjects,
+    });
+    if (!isIssuesHostIntegrationId(options.providerId)) {
+        warnings.push(issueTrackerOnlySurfaceWarning(options.providerId, options.connectionId, 'Issue-tracker project reads'));
+        return emptyPage(true);
+    }
+    const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId);
+    if (integration == null) {
+        // A supplied connectionId that no longer resolves is a broken connection, not an empty account.
+        const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId);
+        warnings.push(...early.warnings);
+        return emptyPage(early.fetchFailed);
+    }
+    if (!isIssuesIntegration(integration)) {
+        warnings.push(issueTrackerOnlySurfaceWarning(options.providerId, options.connectionId, 'Issue-tracker project reads'));
+        return emptyPage(true);
+    }
+    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId);
+    await ctx.forceRefreshIfRequested(integration, options.forceSync, options.connectionId);
+    const { value: resources, warning: resourcesWarning } = await runCaptured(options.providerId, domain, options.connectionId, () => integration.getResourcesForUserResult(options.connectionId));
+    if (resourcesWarning != null) {
+        warnings.push(resourcesWarning);
+    }
+    if (resources == null || resources.length === 0) {
+        const fetchFailed = resourcesWarning != null && resources == null;
+        return emptyPage(fetchFailed, false, fetchFailed ? discoveryFailureRetry() : undefined);
+    }
+    const scopedResources = options.org != null ? resources.filter(r => resourceMatchesOrg(r, options.org)) : resources;
+    if (scopedResources.length === 0) {
+        return emptyPage();
+    }
+    const { value: projectsResult, warning: projectsWarning } = await runCaptured(options.providerId, domain, options.connectionId, () => integration.getProjectsForResourcesWithMetadataResult(scopedResources, options.connectionId));
+    if (projectsWarning != null) {
+        warnings.push(projectsWarning);
+    }
+    // Partial project discovery: continue with the resources that succeeded, but surface per-resource
+    // failures as warnings and remember to mark the page fetchFailed so the caller knows some issues may be
+    // missing. `projectDiscoveryFailed`/`projectDiscoveryTruncated` are OR-ed into the page's
+    // fetchFailed/truncated at every return below (a truncated-but-not-failed discovery, e.g. a paging
+    // backstop, still means the project set is incomplete).
+    const projectDiscoveryAssessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, projectsResult?.metadata);
+    const projectDiscoveryFailed = projectDiscoveryAssessment.fetchFailed;
+    const projectDiscoveryTruncated = projectDiscoveryAssessment.truncated;
+    const projects = projectsResult?.values;
+    if (projects == null || projects.length === 0) {
+        const fetchFailed = (projectsWarning != null && projectsResult == null) || projectDiscoveryFailed;
+        return emptyPage(fetchFailed, projectDiscoveryTruncated, fetchFailed || projectDiscoveryTruncated ? discoveryFailureRetry() : undefined);
+    }
+    const matchedProjects = options.project != null ? projects.filter(p => resourceMatchesOrg(p, options.project)) : projects;
+    // Validate the requested filters against what this provider supports (e.g. Linear/Trello support only
+    // Assignee). An unsupported filter must not silently degrade — Linear/Trello ignore the requested type
+    // and apply Assignee regardless — so warn + fetchFailed instead of returning a differently-scoped set.
+    if (options.filters?.length) {
+        const supported = providersMetadata[options.providerId]?.supportedIssueFilters;
+        const allSupported = supported != null && options.filters.every(f => supported.includes(f));
+        if (!allSupported) {
+            warnings.push(otherWarning(options.providerId, domain, options.connectionId, `One or more requested issue filters are not supported by '${options.providerId}'.`));
+            return emptyPage(true);
+        }
+    }
+    // `includeAllAssignees` drops the user scope, but a user-relative filter (Author/Mention) is meaningless
+    // without a user. Passing both to the provider degrades silently: Jira, seeing no user, falls through to
+    // an unscoped project fetch and returns EVERY issue instead of the requested author's/mentions. Reject
+    // the incompatible combination up front rather than publishing a differently-scoped set as the result.
+    if (options.includeAllAssignees === true && options.filters?.some(f => f !== IssueFilter.Assignee)) {
+        warnings.push(otherWarning(options.providerId, domain, options.connectionId, `\`includeAllAssignees\` cannot be combined with an author/mention filter for '${options.providerId}' (those filters require a user scope).`));
+        return emptyPage(true);
+    }
+    // Scope to the current user's assigned issues unless the caller broadens to all assignees. Resolve the
+    // handle from each resource's own account (multi-account safe), capturing any error so its kind
+    // (e.g. auth) is preserved rather than collapsed to a generic warning.
+    let usersByResourceId;
+    let accountLookupFailed = false;
+    if (options.includeAllAssignees !== true) {
+        usersByResourceId = new Map();
+        const accounts = await mapBounded(scopedResources, providerFanOutConcurrency, async (resource) => ({
+            resource: resource,
+            ...(await runCaptured(options.providerId, domain, options.connectionId, () => integration.getAccountForResourceResult(resource, options.connectionId))),
+        }));
+        for (const { resource, value: account, warning: accountWarning } of accounts) {
+            const user = account?.username ?? account?.name ?? undefined;
+            if (user != null) {
+                usersByResourceId.set(resourceIdForProject(resource) ?? resource.key, user);
+                continue;
+            }
+            warnings.push(accountWarning ??
+                otherWarning(options.providerId, domain, options.connectionId, `Could not resolve the current user for '${resourceLabel(resource)}'; skipping that resource to avoid returning issues assigned to others.`));
+            accountLookupFailed = true;
+        }
+    }
+    const fallbackUserForUnscopedProject = scopedResources.length === 1 && usersByResourceId?.size === 1
+        ? usersByResourceId.values().next().value
+        : undefined;
+    const userForProject = (project) => {
+        const resourceId = resourceIdForProject(project);
+        if (resourceId != null) {
+            const user = usersByResourceId?.get(resourceId);
+            if (user != null) {
+                return user;
+            }
+        }
+        // Some providers/tests return project descriptors without their parent resource id. When we have only
+        // one scoped resource, re-use that sole resolved user rather than silently dropping every project.
+        return fallbackUserForUnscopedProject;
+    };
+    const retryProjectKeys = new Set();
+    const completedProjectKeys = new Set(priorCompletedProjects);
+    for (const retryProject of priorRetryProjects) {
+        completedProjectKeys.delete(retryProject);
+    }
+    const scopedProjectsWithUsers = usersByResourceId != null
+        ? matchedProjects.filter(project => {
+            if (userForProject(project) != null)
+                return true;
+            const key = projectKey(project);
+            retryProjectKeys.add(key);
+            completedProjectKeys.delete(key);
+            return false;
+        })
+        : matchedProjects;
+    // Select the untouched window plus any earlier windows/projects that explicitly need retrying. Keys
+    // include the parent resource so two trackers can reuse the same project id without collapsing.
+    const projectsByRetryKey = new Map(scopedProjectsWithUsers.map(project => [projectKey(project), project]));
+    const scopedProjectsByKey = new Map();
+    const addScopedProject = (project) => {
+        const key = projectKey(project);
+        if (completedProjectKeys.has(key))
+            return;
+        scopedProjectsByKey.set(key, project);
+    };
+    for (const retryProject of priorRetryProjects) {
+        const project = projectsByRetryKey.get(retryProject);
+        if (project != null) {
+            addScopedProject(project);
+        }
+        else if (projectDiscoveryFailed || projectDiscoveryTruncated) {
+            retryProjectKeys.add(retryProject);
+        }
+    }
+    const windowPages = new Set(priorRetryPages);
+    if (normalWindowPage != null) {
+        windowPages.add(normalWindowPage);
+    }
+    if (!paginated && (projectDiscoveryFailed || projectDiscoveryTruncated)) {
+        windowPages.add(1);
+    }
+    if (paginated) {
+        for (const windowPage of windowPages) {
+            const windowStart = (windowPage - 1) * projectsPerPage;
+            for (const project of scopedProjectsWithUsers.slice(windowStart, windowStart + projectsPerPage)) {
+                addScopedProject(project);
+            }
+        }
+    }
+    else if (compositeCursor == null || priorRetryPages.length > 0) {
+        // An unpaged retry-only cursor should re-read only the explicitly failed projects already added
+        // above. Discovery retries still rescan the aggregate set so newly recovered projects are included.
+        for (const project of scopedProjectsWithUsers) {
+            addScopedProject(project);
+        }
+    }
+    const scopedProjects = [...scopedProjectsByKey.values()];
+    const furthestWindowPage = windowPages.size > 0 ? Math.max(...windowPages) : normalWindowPage;
+    const normalWindowEnd = furthestWindowPage != null ? furthestWindowPage * projectsPerPage : scopedProjectsWithUsers.length;
+    const nextPage = paginated && furthestWindowPage != null && scopedProjectsWithUsers.length > normalWindowEnd
+        ? furthestWindowPage + 1
+        : undefined;
+    const retryWindowPages = () => {
+        if (!projectDiscoveryFailed && !projectDiscoveryTruncated && retryProjectKeys.size === 0) {
+            return [];
+        }
+        const pages = new Set(windowPages);
+        if (pages.size === 0) {
+            // A terminal retry has no untouched next window to identify its origin. Keep a manual window
+            // marker so a later partial discovery can reconcile against the projects already emitted.
+            pages.add(paginated ? Math.max(1, page - 1) : 1);
+        }
+        return [...pages];
+    };
+    if (scopedProjects.length === 0) {
+        // The discovered projects didn't intersect the requested filter/window, or every matching resource
+        // failed user resolution. If discovery or account lookup was partial, the empty result is not a
+        // proven-empty account — carry `fetchFailed` so the caller knows issues may be missing.
+        return emptyPage(projectDiscoveryFailed || accountLookupFailed, projectDiscoveryTruncated, {
+            nextPage: nextPage,
+            pages: retryWindowPages(),
+            projects: [...retryProjectKeys],
+            completedProjects: [...completedProjectKeys],
+        });
+    }
+    const perProject = await mapBounded(scopedProjects, providerFanOutConcurrency, async (project) => ({
+        project: project,
+        ...(await runCaptured(options.providerId, domain, options.connectionId, () => integration.getIssuesForProjectWithTruncationResult(project, {
+            user: userForProject(project),
+            filters: options.filters,
+        }, options.connectionId))),
+    }));
+    // Partial project discovery means some projects' issues are missing from this page; propagate it so the
+    // page reports fetchFailed even when every discovered project's own read succeeded.
+    let fetchFailed = projectDiscoveryFailed || accountLookupFailed;
+    // A project whose internal page-drain hit its backstop (Jira/Linear cap at maxPagesPerRequest) reports
+    // `truncated`; surface it as `page.truncated` so a windowed read isn't published as having drained each
+    // project completely.
+    let projectTruncated = projectDiscoveryTruncated;
+    let drainMetadata;
+    for (const { project, value: result, warning } of perProject) {
+        const key = projectKey(project);
+        const retryProject = result == null;
+        if (warning != null) {
+            warnings.push(warning);
+            fetchFailed = true;
+            projectTruncated = true;
+        }
+        // A thrown/unsupported read (e.g. Linear not-implemented) surfaces as a warning with no value;
+        // mark the aggregate as fetchFailed so an empty result isn't mistaken for "no issues".
+        if (result == null) {
+            fetchFailed = true;
+        }
+        if (result != null) {
+            items.push(...result.values);
+            if (result.truncated) {
+                projectTruncated = true;
+            }
+            if (result.metadata != null) {
+                drainMetadata = mergeCollectionMetadata(drainMetadata, result.metadata);
+            }
+        }
+        if (retryProject) {
+            retryProjectKeys.add(key);
+            completedProjectKeys.delete(key);
+        }
+        else {
+            // A usable partial/truncated project is emitted once and remains structurally incomplete.
+            // Re-running the same project cursor would normally return the same prefix and duplicate it
+            // across facade pages; only a project that returned no value is safe to retry automatically.
+            completedProjectKeys.add(key);
+        }
+    }
+    const drainAssessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, drainMetadata);
+    fetchFailed = fetchFailed || drainAssessment.fetchFailed;
+    projectTruncated = projectTruncated || drainAssessment.truncated;
+    // A per-project read that returned data but couldn't confirm completeness (e.g. Trello's provider-native
+    // cap) sets `truncated` without a structured failure. Add one provider-neutral incompleteness warning so
+    // the caller sees the truncation, but only when no warning already explains it (avoid duplicate noise).
+    if (projectTruncated && warnings.length === 0) {
+        warnings.push(otherWarning(options.providerId, domain, options.connectionId, 'Some issues were omitted; the provider returned an incomplete result.'));
+    }
+    const retryPages = retryWindowPages();
+    const cursor = toIssueTrackerPageCursor({
+        currentPage: page + 1,
+        unpaged: !paginated,
+        nextPage: nextPage,
+        retryPages: retryPages,
+        retryProjects: [...retryProjectKeys],
+        completedProjects: (trackCompletedProjects ||
+            projectDiscoveryFailed ||
+            projectDiscoveryTruncated ||
+            retryProjectKeys.size > 0) &&
+            (retryPages.length > 0 || nextPage != null)
+            ? [...completedProjectKeys]
+            : [],
+    });
+    return {
+        items: items,
+        warnings: warnings,
+        page: { currentPage: page, itemsPerPage: items.length, truncated: projectTruncated || undefined },
+        // Failed-project retries alone are manual. Only an untouched project window is automatic progress.
+        hasMore: nextPage != null && cursor != null,
+        cursor: cursor,
+        fetchFailed: fetchFailed || undefined,
+    };
+}
+//# sourceMappingURL=issueTracker.js.map

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

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

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

@@ -0,0 +1,34 @@
+import type { IssueShape } from '../../../git/models/issue.js';
+import type { IntegrationIds } from '../constants.js';
+import type { IssueFilter, ProviderReposInput } from '../providers/models.js';
+import type { ProviderPagedResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function listIssuesPage(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    repos?: ProviderReposInput;
+    /** Narrows the account-wide read to one org/account. Requires a host with a project layer (Azure). */
+    org?: string;
+    /** Narrows the account-wide read to one project. Requires a host with a project layer (Azure). */
+    project?: string;
+    /**
+     * Narrows to the requested relationship(s). On the account-wide path this replaces the provider's own
+     * definition of "my issues" (GitHub/GHE: authored ∪ assigned ∪ mentioned; Azure: assigned ∪ authored;
+     * GitLab: assigned-to-me), so `[Assignee]` yields `assignee:@me` everywhere it's expressible. A set the
+     * provider can't express server-side is refused whole (warning + `fetchFailed`), never widened — check
+     * getSupportedFilters first to avoid that path.
+     */
+    filters?: IssueFilter[];
+    /** Broadens the read to every assignee. Contradicts `filters`; passing both is refused. */
+    includeAllAssignees?: boolean;
+    page?: number;
+    cursor?: string;
+    itemsPerPage?: number;
+    forceSync?: boolean;
+    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<ProviderPagedResult<IssueShape>>;
+//# sourceMappingURL=issues.d.ts.map

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

@@ -0,0 +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,CAuV1C"}